home *** CD-ROM | disk | FTP | other *** search
/ CD Exchange / CD Exchange - Volume 1.iso / graphics / utils / videotracker / utils1 / protracker_doc / protracker_doc
Text File  |  1993-05-26  |  101KB  |  2,839 lines
  1. Peter van Campen: I had to put the manuals of this program in one
  2. file to save diskspace.
  3.  
  4. ***************************************************************************
  5.  
  6. PROTRACKER 3.10 Beta. Amiga Format version.
  7. -------------------------------------------
  8.  
  9. Protracker 3.10 is (C) Copyrighted 1992-93 by the Authors
  10. All rights reserved. Commercial use prohibited without written
  11. permission from the Authors.
  12.  
  13. Commercial distribution licensed per 3rd of May 1993 is restricted to
  14. the Amiga Format magazine and AM/FM Music Magazine. The Authors, however,
  15. reserve the right to commercially distribute the program and all its 
  16. included fascilities, be it examples, documentation and other utilities.
  17. The Authors reserve all rights to  withdraw any license without notice and
  18. for future licensing of this program.
  19.  
  20. Disclaimer: We are not in any way responsible for data loss or any other
  21. faults caused by the use of this program. By using this program, you
  22. agree to these terms.
  23.  
  24. Protracker is supplied as is, and cannot be distributed without the 
  25. following files included:
  26.  
  27.     - Protracker executable ;)
  28.     - This text-file
  29.     - mathtrans.library
  30.     - powerpacker.library 
  31.     - mod.The Moebius.pp
  32.  
  33. (Note: PowerPacker.library is (C) 1992 Nico Francois.)
  34.  
  35. On these terms, Protracker is put in the public domain for non-commercial
  36. purposes. I.e prices may not exceed costs for disk and postage.
  37.  
  38. About this version:
  39. -------------------
  40.  
  41. This version of Protracker is a betaversion exclusively for the Amiga Format
  42. magazine. Protracker 3.10 by Cryptoburners is the latest edition to the
  43. Protracker family and is entirely based upon Protracker 1.3/2.0 by
  44. Lars Hamre of The Amiga Freelancers.
  45.  
  46. Main features of this beta version:
  47. -----------------------------------
  48.  
  49. * Dramatically improved user interface.
  50.     - Hires 640x200 screen display.
  51.     - Better input handling.
  52.     - Scrollbars added where required.
  53.     - Date/Time online.
  54.     - Overall volume controller on screen.
  55. * A new improved 7-note chord editor, recalculates loops.
  56. * Improved and faster sample editing. Unlimited zoom levels.
  57. * Full compatibility with all existing OS versions including OS3.0
  58. * Better multitasking capabilities.
  59. * New sample edit options, includes Invert, Maximize, NormalDC, Normalize.
  60. * Mouse controlled editing made possible.
  61. * Full Powerpacker support, read/write/encrypt possible.
  62. * Added real VU-meters.
  63. * New configurable options: 
  64.     - Screen positioning.
  65.     - Lace on/off for genlock users.
  66.     - Multicached disk directories.
  67. * Several interesting bugs (Batteries not included).
  68.  
  69. Final version will feature
  70. --------------------------
  71.  
  72. The final version features massive improvements in comparison with every other
  73. tracker around :) New features include:
  74.  
  75. * For the first time in Amiga history: Improved sound quality! Actual 12 bit 
  76.   sound dynamics using a new and revolutionary algorithm. No addititional
  77.   add-ons required, furthermore, no extra storage usage. Fully compatible with
  78.   traditional 8-bit Amiga sounds. 
  79. * A whole new range of DSP effects for your samples, including such effects as:
  80.     - Low, high, band and allpass filters (IIR filters).
  81.     - Comb filters.
  82.     - Shelving low and high filters.
  83.     - Multitap delay/feedback algorithms.
  84. * Reads and converts numerous 16 bit samples, including Maestro and AIFF.
  85. * Amigaguide documentation (A big sucker).
  86.  
  87. Credits for the final version:
  88. ------------------------------
  89.  
  90. Main programming by:        Ivar Just Olsen, Bjarte Andreassen and Tom Bech.
  91. Additional programming by:  Lars Hamre and Markus Weichlsbaum.
  92. Documentation assembled by: Oddgeir Hvidsten, Jostein D.Gjelsvik and Tom Bech.
  93.  
  94. Thanks to:                  Vishnu for the playroutine for the final version.
  95.                             Arild Gjerd for letting us use his ex. A2000...
  96.                             Oddgeir for his nice A1200 and coffee :)
  97.                             All betatesters.. especially U4ia, Janne, Essl,
  98.                             MnemotroN, Tai Pan, ALFred and Bilbo.
  99.  
  100. Addresses:
  101. ----------
  102.  
  103. Contact one of the authors if you have bugreports or if you have questions
  104. about licences. If you have access to Internet please send all E-Mail to
  105.  
  106. Oddgeir Hvidsten: hhioh@hi.uib.no (preferably) or 
  107. Tom Bech:         db62@hp825.bih.no (not after 4th of June '93).
  108.  
  109. Ordinary mail:
  110.  
  111. Ivar Just Olsen
  112. Mobergslien
  113. 5200 Os
  114. Norway
  115.  
  116.  
  117. BILL THE CAT FOR PRESIDENT!!
  118.  
  119.  
  120. ***************************************************************************
  121.  
  122. -------------------------------------------------------------------------
  123. Protracker V2.2 Release A - (C) 1992 Mushroom Studios/Noxious  22/06-1992
  124. -------------------------------------------------------------------------
  125.  
  126. Protracker is a Public Domain program, and may may be copied freely and
  127. included in any PD library. You may not charge anything for the program
  128. other than the cost of the disk and the PD-service.
  129.  
  130. This disk should contain the following files:
  131.  
  132.   PT2.2A_Beta            -  The main program.
  133.   PT2.2A_Beta.info       -  The Icon for Protracker.
  134.   PROP                   -  Protracker module player.
  135.   PT.TempoCalc.txt       -  How to calculate tempo etc.
  136.   PT-Play.s              -  Playroutine for the Seka or DevPac assemblers.
  137.   PT-CIAPlay.s           -  Playroutine for CIA timing.
  138.   PT.FileFormat.txt      -  Description of the file format.
  139.   PT.Effects.txt         -  Quick help on all effect commands.
  140.   PT.help                -  Online helpfile for PT2.2A (press the Help key).
  141.   PT.help.txt            -  Read-/Printable version of the help file.
  142.   PT.help.txt.info       -  Icon for the PT.help.txt file.
  143.   PT.config-00           -  Default configuration file.
  144.   PT.Update!             -  Textfile with changes from PT2.1A
  145.   PT.Update!.info        -  Icon for the PT.Update! file.
  146.   PT.ReadMe!             -  ****--> This file <--**** 
  147.   PT.ReadMe!.info        -  Icon for the PT.ReadMe! file.
  148.  
  149. Some info..
  150. -----------
  151.  
  152. This disk contains all the necessary files to run Shell, CLI, and all the
  153. most used CLI-Commands. It is possible to print songs, but we'we only
  154. included the Generic printerdriver, so you'll have to install your own.
  155. Remember to set the new printerdriver with Preferences. If you make your
  156. own workdisk, remember to copy the commands "Run" and "EndCLI".
  157.  
  158. If you are going to make make a compact-disk containing Protracker, please 
  159. include PT.help and powerpacker.library!!! THIS IS VERY IMPORTANT!!!
  160.  
  161.              DO NOT ATTEMPT TO EDIT THE HELP-FILE!!!
  162.  
  163. The first 1024 bytes are a text-offset index for Protracker, so keep off. 
  164.  
  165. For more info, press the HELP key when you have started Protracker.
  166.  
  167. It isn't possible to load old configuration files with PT2.2A, but if you
  168. load an old config-file into an editor and change the first 5 letters to
  169. "PT2.2", you might be able to use it, but some new functions may be set to
  170. zero though. Remember to check the DMA-wait and all the other functions
  171. or you'll experience some crashes etc...
  172.  
  173.  
  174.  
  175. --- Protracker history ---
  176.  
  177. First Version 1.0 (A) - Full of bugs...
  178.  
  179. Bugs corrected in V1.0 Release B:
  180. ---------------------------------
  181.  - PatternLoop (It always jumped to the start of the pattern, not the loop)
  182.  - Zap had put FineTune AND Glissando-Control in the same command! (E3)
  183.  - Fade Up / Down caused shit and even a few gurus!
  184.  - Delete Pos inserted pattern 77 (!) at position 127 in the song, causing
  185.    it to be longer than 80k!
  186.  - Filter All Samples was slow as hell because it tried to filter non-
  187.    existant samples.
  188.  - If you selected sample 0 from the keypad, it always played the last
  189.    sample played as sample 0!
  190.  - A590 harddisk owners couldn't use the keyboard because of the way Mahoney
  191.    & Kaktus set up the keyboard interrupt (we used their NT1.1 routine).
  192.  - Entering the help screen when in the midi screen fucked up the display.
  193.  - Escaping from Mix exited from the whole edit op.!
  194.  - CutBeg no longer fucks up the Sample length and Pos.
  195.  - The help file was FULL of bugs / misspellings.
  196.  
  197. Bugs corrected in V1.0 Release C:
  198. ---------------------------------
  199.  - Error in Finetune-table2 (note B-2)
  200.  - Abort Load sometimes caused a guru!
  201.  - Toneportamento (cmd 3) didn't work correctly with finetune.
  202.  - PLST screen was one pixel off.
  203.  
  204.  MIDI screen was removed.
  205.  
  206.  
  207. Changes and improvements from Protracker V1.0C to V1.1A:
  208. --------------------------------------------------------
  209.  
  210. General:
  211.   - Protracker will now run if you have Kickstart 2.0 installed!
  212.     (A500, A1000, A2000, A3000 etc...)
  213.   - Protracker will also "Auto runback" when you start from CLI!
  214.     There's no need to use the 'run' command.
  215.   - Keyboard and mouse input is provided by an InputHandler with prior-
  216.     ity 52. The handler will grab all RAWKEY and RAWMOUSE events from
  217.     the input.device before they reach intuition. PT will no longer
  218.     interfere with windows and gadgets on the intuition screen behind.
  219.   - Keyboard buffer. Wow!!! Now you can play really fast, and PT won't
  220.     miss a single key (...well, not as many as it used to before...).
  221.   - The vertical blank interrupt no longer patches the vector itself, but
  222.     uses the AddIntServer function.
  223.   - The playroutine creates it's own CIA or VBLANK interrupt, and it will
  224.     not be removed if a song is playing when you go to CLI/Workbench.
  225.   - Text input routine changed a little. Use mouse to set pos and to exit.
  226.   - Improved "Out of memory" handling (hopefully no more gurus...).
  227.   - Only the first 2 bytes of a sample will be zeroed (were the first 4).
  228.   - Lots of new keyboard commands/shortcuts using the Alt key.
  229.   - Vibrato depth changed to be compatible with NT2.0. Double all your
  230.     depth numbers if you load old protracker songs.
  231.   - Funk Repeat changed to Invert Loop (may trash your samples though).
  232.   - Play samples from the keypad (dot mode) when pressing backslash.
  233.  
  234. Main Screen:
  235.   - MIDI screen has been removed. Changed to sampler instead. MIDI input
  236.     is still there, but there's no MIDI output. Sorry...
  237.   - Quadrascope. Four channel oscilloscope that displays the samples
  238.     in real-time, even when playing from keyboard. The good old spectrum
  239.     analyzer is still there, just click on the scope to toggle.
  240.   - Tempo gadget. Default is 125 BPM (normal vblank speed), but that can be
  241.     changed if you select CIA timing on Setup2. Range is 32-255 BPM, and
  242.     can also be changed with the 'F' effect command (speed/tempo).
  243.   - Repeat and replen will be updated in the samples when you change them.
  244.     You no longer have to press a key to hear the new loop.
  245.   - Protracker should now be able to show up to 10/16 megs of freemem.
  246.   - Error messages when PLST or Config not found.
  247.   - Click to enter position, pattern and length with the keyboard.
  248.  
  249. Disk Op.:
  250.   - Choose RAW or IFF when saving samples.
  251.   - Samples can be saved with IFF-loops.
  252.   - Change path without reading directory.
  253.   - All 30 characters in filename/directory stored (was 24).
  254.   - Shows directories, just click to add directory to path.
  255.   - Parent directory gadget.
  256.   - One preset and several default paths for modules/songs/samples.
  257.   - PT will now read an "unlimited" number of directory entries (was 200).
  258.  
  259. Setup:
  260.   - The only thing that's happened here is a small gadget labeled "2".
  261.     Pressing it will put you in...
  262.  
  263. Setup2:
  264.   - 8 new on/off toggles.
  265.     Override: Load/save sample from samplepath even if there's a path
  266.       in the samplename. ST-37:bigbadbass with override will be loaded
  267.       from DF0: (or whatever) instead of ST-37:. You may want to put
  268.       all your samples in one big directory on your harddisk...
  269.     NoSamples: Will load a song without asking for the samples.
  270.     BlankZero: This will show the samplenumbers in the pattern in the
  271.       same way as Noisetracker 1.2 (Zeros are blanked out).
  272.     Show Dirs: If on, directories will be shown in Disk Op.
  273.     Show Publ: If on, PT will show all free Public memory, otherwise
  274.       just free Chip memory.
  275.     CutToBuff: If on, the part of the sample cut away in the sample
  276.       editor will be saved in the copybuffer.
  277.     Load Loop: Will load loops from an IFF file when loading a sample,
  278.       or adding a path in the sampleeditor.
  279.     Slow Mode: Use this toggle if you have a 25 Mhz A3000 where every-
  280.       thing is faster. Turning it on might help.
  281.   - Set Default paths.
  282.   - You can set the maximum number of presets (used to be 2500).
  283.   - DMA wait. Use this on 25MHz Amigas (normally 300, use 900 on A3000).
  284.   - Set tuning tone (note and volume).
  285.   - Select CIA or VBlank timing.
  286.   - Set default CIA tempo.
  287.   - Spectrum Analyzer/VU-meter copper color editor!
  288.  
  289. Preset Editor:
  290.   - Use Preset removed, inserted Delete Disk instead.
  291.   - You can now save Finetune instead of Volume in the PLST. 
  292.   - ST-disk number changed to hex (ST-00 --> ST-FF)!
  293.   - Adding samples with IFF-loops to the presetlist is possible.
  294.   - Proper PLST allocation. Protracker will no longer allocate
  295.     any memory if there's no PLST.
  296.  
  297. PLST:
  298.   - ST-disk number changed to HEX. This means you can have
  299.     up to $FF, or 255 ST-disks (used to be 99).
  300.  
  301. Sampler/Sample Editor:
  302.   - Sample Graphing like Audiomaster. With Show Range, Show All,
  303.     Zoom Out, Range All, etc...
  304.   - Play either Waveform, Display or Range.
  305.   - Repeat points are shown, and can be dragged around.
  306.   - Loop on/off toggle.
  307.   - A line shows current position when playing back a sample.
  308.   - A sampler just like on NT2.0.
  309.   - Resample function w/tuning tone.
  310.   - Cut, Copy and Paste functions.
  311.   - Cursor to beginning/end.
  312.   - Swap current sample with copybuffer.
  313.  
  314. Edit Op.:
  315.   1 - Transpose All bug removed.
  316.   2 - Move changed to Copy (use this to copy samples too).
  317.   3 - Upsample changed a tiny bit (allocation).
  318.   3 - Most functions will now work with marked ranges.
  319.  
  320. Bugfixes and changes from PT1.1A to PT1.1B:
  321. -------------------------------------------
  322.  
  323. - Load gadget no longer hangs the program when trying to load a file that
  324.   doesn't exist.
  325. - Better filehandling with error messages.
  326. - Repeat and replen check installed (Rel. A hanged when replen accidentally
  327.   got the value zero).
  328. - Repeat and replen were swapped when loading an IFF sample.
  329. - Only RepLen values in IFF samples were added in the preset-editor.
  330. - Tune memory wasn't always updated when editing samples.
  331. - Swap Buffer debugged.
  332. - The arpeggio sounded weird because the pitch wasn't set back at the
  333.   right time.
  334. - Shift speeds up the scrolling in the PLST and preset-editor.
  335.  
  336. ---------------------------------------------------------
  337. Bugfixes and improvements from PT1.1B(& PT2.0) to PT2.1A:
  338. ---------------------------------------------------------
  339.  
  340. - mod. prefix was shown in the file-list if it wasn't lowercase only.
  341. - ReturnfromCLI requester enhanced with quitgadget.
  342. - Gadgetpositions fixed properly.
  343. - Accidental and Diskspace bugs fixed.
  344. - Editskip has now got an indicator.
  345. - DISK OP., PLST and PRESET-ED screens have TOP/BOTTOM gadgets.
  346. - PLST screen has now got Up/Down arrows.
  347. - PT can load&save powerpacked samples/modules.
  348. - PT can load&save tracks/patterns.
  349. - Format disk bug has been fixed (I hope).
  350. - Volume,Repeat,Replen,Pos & Mod is now editable from the keyboard.
  351.   Just click on the numbergadgets.
  352. - You can now choose an autoinserteffect of your own.(One of the ten
  353.   effectmacros).
  354. - The bug that completely turned the sound off when stopping the recording
  355.   has now been fixed.
  356. - You are now able to fastscroll the file- and presetlist to the next
  357.   startcharacter.Try it out yourselves...hard to explain.
  358. - The preset-ed routines have been corrected.To use your old PLST, simply
  359.   delete preset #0.
  360. - The metronome has now got an accent on the first beat.
  361. - A metronome keyboard toggle has been included.
  362. - The metronomechannel can easily be changed to the current cursorposition.
  363. - Most of the numbergadgets can now be zero'ed.
  364. - Better patternrefresh when doing keyboard I/O.
  365. - PT now reads the dir after rename/save/delete if the Autodirtoggle is on.
  366. - You can solo a channel with the mouse by holding the right mousebutton
  367.   while pressing 1,2,3 or 4.
  368. - You can pass an argument from workbench/shell/cli to automatically load
  369.   a module when PT starts.
  370. - Powerpacker crunching/decrunching with powerpacker.library!
  371.   PT will automaticly append/remove ".pp" to/from the filename.
  372. - You can save an Icon together with the module.
  373.  
  374. ------------------------------------------------
  375. Bugfixes and improvements from PT2.1A to PT2.2A:
  376. ------------------------------------------------
  377.  
  378. - I have fixed the chip-mem bug from PT2.1A.(it didn't work with chipmem only)
  379. - When Preset-ed screen was shown,you couldn't use the gadgets on the lower
  380.   part of the main- or sample-screen.
  381. - When autoexitdirtoggle was off,PT didn't change the songname when you loaded
  382.   a new song/module until you exit from disk op.
  383. - If you resampled a sample with big difference between the tunetone and the
  384.   resampletone then the new length was incorrectly computed.
  385. - If you ran out of memory when allocating crunchbuffersize then ... software
  386.   failure! This should work just fine now.
  387. - If you loaded a sample with a '.' in the samplename then PT set the length
  388.   incorrectly in some cases (see below)
  389. - Save module should work fine now.(another nasty bug is swept away!)
  390. - The Sampler works fine on ks2.0 (This version tests diskactivity before
  391.   sampling, PT1.3 doesn't!)
  392.   ***********************************************************************
  393.   * Thanks to Matrix/LSD for sending the working piece of source to me! *
  394.   ***********************************************************************
  395. - The timer is updated when you play a song while jumping out to Workbench.
  396. - The Loopsprites are working fine with screenadjust.
  397. - Stepplay works fine now. Amiga+Backspace is gone though.
  398. - MIDI in functions are working now, I hope!
  399. - Inputhandler debugged a little.
  400. - ShowFreeDiskGadget debugged (again). Before it showed 2 sectors too much.
  401. - If you pressed the deletefile gadget and then pressed a directoryname in
  402.   the list then the dir was added to the path but the directory wasn't opened.
  403.   This is now fixed.
  404. - PrintSong now prints the patternlist with decimal values. It prints all
  405.   patterns.(Older versions of PT missed to print the highest pattern)
  406. - I have implemented a chord maker.
  407. - I have implemented e Position-Editor.
  408. - On request, I have made ''multitasking'' like in PT1.3.
  409. - ProTracker has it's own screen. When the PT screen is in front of all other
  410.   screens, PT will wake up.
  411. - The browse function is modified to act like PT1.3. It shows the current
  412.   devices and disknames.
  413. - If you hold the right mousebutton while pressing the browsegadget a disklist
  414.   will pop up showing all the device- and disknames from the browsegadget in
  415.   the filenamewindow. Pressing a name will autoload that directory.
  416. - If you press LeftShift+any key 0-9 a-z while in DiskOp,  PLST or PresetEd,
  417.   PT will move you to the position in the list with a name beginning with the
  418.   corresponding character.
  419. - If you use MIDI I've added two new keys. A-2 and B-2 on the Synthkeyboard
  420.   are used as SampleNumber Up/Down! I have also Transposed the MIDInotes input
  421.   one octave down (because Dolphin has a small keyboard and couldn't access
  422.   the upper octave,C#3 - B-3).
  423. - I have added a SaveExecutable option.
  424. - 9 new toggles.
  425.  
  426. Known bugs, errors, stupid things and other crap:
  427. -------------------------------------------------
  428.  
  429. - If you load a song or module that's not a proper ST-module,
  430.   Protracker may trash the upper left of the screen and/or crash.
  431.   This screen-trashing may also happen other times. Don't ask us why
  432.   or when. There is really no proper way to check if a file is a module
  433.   or song. We check for "M.K." at offset 1080, and if isn't found,
  434.   Protracker asks if you want to load it with 31 samples, since it may
  435.   be a Startrekker module. If you answer no, PT assumes it's an old
  436.   15 samples song/module.
  437.  
  438. - If you format a disk with Protracker, it's possible to save files to the
  439.   disk, but if you try to load the files you just saved, nothing comes up
  440.   in the disk op. screen.  If could be that the Amiga has some problems
  441.   validating the disk, but there are no such messages. We'll have a look
  442.   at the Format routine.If you get any problems, try to take out the disk
  443.   and insert it again.PT should now re-read the dir.
  444.  
  445. - You cannot have two presets with the same name on different ST-disks.
  446.  
  447. - I have noticed that powerpacker.library crunches some samples/modules
  448.   improperly. (This goes with the powerpacker program as well).
  449.   Be sure to check the packed files before you delete the sourcefiles!
  450.  
  451.  
  452. If you send us bug reports, please describe the bugs properly, so that we
  453. can figure them out without too much trouble. State how, when and where
  454. the bug appeared, if it's there all the time, or just happened once.
  455. If you can tell us how to duplicate what you did to get the bug, it
  456. would be great. THEN we can try to eliminate it, ok?
  457.  
  458.  
  459. If you want to contact us for any reason (please do) write to:
  460.  
  461.   Peter "CRAYON" Hanning
  462.   Vinterstigen 12
  463.   14440 Ronninge
  464.   Sweden
  465.  
  466. Or to:
  467.  
  468.   Anders "DOLPHIN" Ramsay
  469.   Fornhojdsvagen 6 II
  470.   15158 Sodertalje
  471.   Sweden
  472.  
  473.   You can also contact us at the Equipoise BBS: +46-755-87404
  474.  
  475. ***************************************************************************
  476.  
  477. -------------------------------------------------------------------------
  478. Protracker V2.2 Release A - (C) 1992 Mushroom Studios / Noxious 22/6-1992
  479. -------------------------------------------------------------------------
  480.  
  481. Protracker is a Public Domain program, and may may be copied freely and
  482. included in any PD library. You may not charge anything for the program
  483. other than the cost of the disk and the PD-service.
  484.  
  485. *** This is an printable version of the PT.help file ***
  486.  
  487.     Written by:  Peter "CRAYON" Hanning
  488.  Layout & Help:  Anders "Dolphin" Ramsay
  489.  
  490.  Thanks must go to the following for contributing with suggestions and
  491.  bug-reports: Gahn, Reverend D, Dolphin, all members of Noxious.
  492.  Devistator/EOC1999     Spirou/Visual Design    Sun/Dreamdealers
  493.  The Green Lark/Aliens  Matrix/LSD (Thanks for the source!)
  494.  Deltabar Dilonardo     Toni Maenpaa            Markus Jentsch
  495.  Alex Kunz              Tritoon/AlphaFlight
  496.  
  497.  
  498.  Hi there!
  499.  
  500.  Here comes PT2.2A, a new version of Protracker, the best tracker around!
  501.  
  502.  There has been several new changes this time to enhance Protracker even
  503.  more! Read more about it in the Readme!.txt file.
  504.  Don't hesitate to contact us if you can't get it working, if there's some-
  505.  thing you can't figure out or if you find any bugs.
  506.  
  507.  Some technical info:
  508.  
  509.    Sourcecode: 440k / 25000 lines
  510.  Main Program: 200k
  511.      GFX data: 80k (packed)
  512.      Worktime: 954541497 hours
  513.      ASM time: about 30 seconds
  514.  
  515.  Something you'd like in the next version of Protracker? Have you found
  516.  any bugs?
  517.  
  518.           Anyway, write to:
  519.  
  520.           Mushroom Studios/Noxious
  521.           Vinterstigen 12
  522.           14440 Ronninge
  523.           Sweden
  524.  
  525.          (No games, please!)
  526.  
  527.  Mushroom Studios are (a subgroup of NOXIOUS):
  528.  
  529.  Peter "CRAYON" Hanning         (Coder,Musician)
  530.  Anders "DOLPHIN" Ramsay        (Musician,Organizer)
  531.  
  532.  
  533.  
  534.                 MAINSCREEN
  535.                 ----------
  536.  ## PLAY ##
  537.  Will play the song from the current position in the song. The pointer
  538.  turns yellow, just to show you what's going on.
  539.  
  540.  ## PATTERN ##
  541.  Will play the current pattern which is shown at the bottom of the screen.
  542.  The pointer turns yellow here as well. Holding down the right button while
  543.  pressing play,pattern or record will play from the current patternposition.
  544.  
  545.  ## EDIT ##
  546.  Will put you in edit mode. The pointer turns blue, and you can enter notes
  547.  and numbers from the keyboard. Use the arrowkeys to move up/down and
  548.  left/right in the pattern. Entering a note or a number will cause the
  549.  pattern to jump one or more slots down.
  550.  
  551.  ## RECORD ##
  552.  Will put you in edit mode, but also play the current pattern or song.
  553.  You can select this in the Edit Options menu. While the pattern or
  554.  song is playing, you can type in notes and numbers from the keyboard,
  555.  and they will appear in the pattern as it scrolls. The notes and numbers
  556.  will also be quantized to the nearest slot, so that keeping a steady rhythm
  557.  is no problem. The pointer will turn blue here as well as in the the normal
  558.  edit mode.
  559.  
  560.  ## STOP ##
  561.  Will stop playing of songs and patterns, recording, and will turn edit
  562.  mode off.
  563.  
  564.  ## CLEAR ##
  565.  Will first ask you what you want to clear. You can clear either all,
  566.  song or samples.
  567.  
  568.  ## EDIT OP. ##
  569.  Will exchange the Spectrum Analyzer with the Edit Menu(s). Pressing more
  570.  than one time will browse through the edit op. screens.
  571.  
  572.  ## DISK OP. ##
  573.  Will go to the File Requester.
  574.  
  575.  ## PLST ##
  576.  Will go to the PLST screen.
  577.  
  578.  ## PSET-ED ##
  579.  Will go to the preset editor.
  580.  
  581.  ## SETUP ##
  582.  Will go to the Setup Screen.
  583.  
  584.  ## SAMPLER ##
  585.  Will go to the Sampler screen.
  586.  
  587.  ## 1, 2, 3 and 4 ##
  588.  Represent the audiochannels of your amiga. When lit, that channel is on.
  589.  When not lit, the channel is muted and and the notes in that track will
  590.  not be played.Holding the right mousebutton will solo the desired channel.
  591.  
  592.  ## TEMPO ##
  593.  The tempo gadget on the status bar is for setting the CIA speed, if CIA
  594.  timing is used. The gadget will be updated every time you set the speed
  595.  using the F command (if CIA that is).
  596.  
  597.  ## I(NSERT) ##
  598.  Insert a position into your song.
  599.  
  600.  ## D(ELETE) ##
  601.  Delete a position from your song.
  602.  
  603.  ## POS ##
  604.  Defines your position in the song-table.Pressing this will put you in the
  605.  Position-Editor.
  606.  
  607.  ## PATTERN ##
  608.  Defines which pattern will be played at a specific position.
  609.  
  610.  ## LENGTH ## (SONG)
  611.  Defines the length of the song.
  612.  
  613.  ## FINETUNE ##
  614.  Tune your untuned samples to match the others.
  615.  
  616.      0 436.4 hz    -1 432.1 hz
  617.      1 439.0 hz    -2 429.6 hz
  618.      2 441.6 hz    -3 426.3 hz
  619.      3 445.1 hz    -4 423.1 hz
  620.      4 447.8 hz    -5 419.9 hz
  621.      5 451.5 hz    -6 416.7 hz
  622.      6 455.2 hz    -7 414.4 hz
  623.      7 457.0 hz    -8 412.0 hz
  624.  
  625.  ## SAMPLE ##
  626.  Choose sample. You can use up to 31, or hex $1F samples in a song.
  627.  Pressing both mousebuttons at the same time will set the samplenumber
  628.  to zero. You can then record the pattern with sample 0 to prevent
  629.  Protracker from setting the volume each time you play a new note.
  630.  
  631.  ## LENGTH ## (SAMPLE)
  632.  The Length gadgets are simply used for setting the length of the sample.
  633.  A sample can be up to 64k, or $fffe long. You can add workspace behind
  634.  the sample by increasing the length and letting go of the button. PT will
  635.  ask if you are sure, and if you are, allocate more memory for the sample.
  636.  
  637.  ## VOLUME ##
  638.  Use this to set the volume the current sample will be played with.
  639.  
  640.  ## REPEAT ##
  641.  Here you set the start of the sampleloop.
  642.  
  643.  ## REPLEN ##
  644.  Here you set the length of the sampleloop.
  645.  
  646.  ## PATTERNNUMBER GADGET ##
  647.  To the middle left of the screen is a box with a number in it. The number
  648.  is the current pattern number. Click on it to type in a new number. When
  649.  in type-in mode, use return, ESC or right mousebutton to exit. This should
  650.  also work on most other such gadgets.
  651.  
  652.  ## A(BOUT) ##
  653.  This one you'll have to experience for yourself.
  654.  
  655.  ## LOAD ## (sample)
  656.  Will simply try to load the current samplename. Use this when you've
  657.  fucked up in the sample editor, and have destroyed a sample.
  658.  
  659.  Pressing both the left and right button on the arrow-gadgets will speed
  660.  them up a bit.
  661.  All numbergadgets except Finetune&Sample allows you to click in the
  662.  gadget and type in the desired value.Holding the right mousebutton while
  663.  pressing them will zero the value.
  664.  
  665.  The main screen has some indicators on the left side of the song- and
  666.  samplename textgadgets.The indicators are as follows:
  667.  M S M 0-9 (Metronome ON, Split keyboard ON, Multi keyboard ON, Editskip)
  668.  I 0-9     (AutoInsert ON, AutoInsert Macro)
  669.  
  670.  
  671.  
  672.                 DISK OP.1
  673.                 ---------
  674.  
  675.  ## PATH ##
  676.  The paths for songs, modules, samples, tracks and patterns can now be
  677.  changed, and they can be up to 31 characters long. To change path, click
  678.  on load song/module/sample/track/pattern or use the arrow indicating
  679.  what path you're at.
  680.  
  681.  ## FREE (DISKSPACE) ##
  682.  Free diskspace can be shown in hex or decimal. Select this on the setup
  683.  screen. Click on "free" to get free diskspace without re-reading the dir.
  684.  
  685.  ## FORMAT DISK ##
  686.  Will format a disk in df0: (Hopefully bug-free)
  687.  
  688.  ## RENAME FILE ##
  689.  Will dir the current directory. Select a filename, and you will be able
  690.  to edit the name.
  691.  
  692.  ## DELETE FILE ##
  693.  Will dir the current directory. Select a file, and it will be deleted
  694.  from the disk.
  695.  
  696.  ## PACK ##
  697.  When on, Protracker will pack songs before saving.
  698.  Modules will be PowerPacked and .pp will be added to the filename.
  699.  
  700.  ## LOAD SONG ##
  701.  Will dir the songs path. Select a song, and it will be loaded and
  702.  decrunched if crunched.
  703.  
  704.  ## SAVE SONG ##
  705.  Will pack the song if pack is on, then save it to the current songs
  706.  path. Remember to enter a name for your song, otherwise PT will not save!
  707.  
  708.  ## LOAD MODULE ##
  709.  Will dir the modules path. Select a module, and it will be loaded.
  710.  Powerpacked modules will be decrunched.
  711.  
  712.  ## SAVE MODULE ##
  713.  Will crunch(Powerpacker) the module if pack is on,then save it to the
  714.  current modules path. Modules can be saved without a name, since they
  715.  always begin with "Mod.".Holding the right button will save as an
  716.  executable file in the current directory.
  717.  
  718.  ## LOAD SAMPLE ##
  719.  Will dir the sample path. Select a sample, and it will be loaded to the
  720.  current sample. IFF headers will be chopped off and loops loaded, if any.
  721.  Powerpacked samples will be loaded and decrunched.
  722.  
  723.  ## SAVE SAMPLE ##
  724.  Will save the current sample as RAW, IFF or PAK(Powerpacked). Select
  725.  this in the "Save" gadget to the right of "Load Sample". IFF loops will
  726.  be saved too(Not with PAK in this version).
  727.  
  728.  ## DIR-BROWSE BUTTON ##
  729.  By pressing this button you can browse through various preset paths, so
  730.  that you won't have to enter them over and over again.Holding right
  731.  mousebutton will show all paths in the file-list window.
  732.  
  733.  ## PATH INDICATOR ##
  734.  Click to change paths without reading dir.
  735.  
  736.  ## 2 ##
  737.  Goto Disk Op.2
  738.  
  739.  ## T(OP) ##
  740.  Will put you at the top of the file-list.Holding the right mousebutton
  741.  will put you at the previous character in the file-list.Try it out!
  742.  
  743.  ## B(OTTOM) ##
  744.  Will put you at the bottom of the file-list.Holding the right mousebutton
  745.  will put you at the next character in the file-list.
  746.  
  747.  Holding shift while pressing a key will put you in the list at the
  748.  corresponding position.
  749.  
  750.  
  751.                 DISK OP.2
  752.                 ---------
  753.  Disk op.2 has alot in common with disk op.1 but with a few additional
  754.  features.
  755.  
  756.  ## LOAD TRACK ##
  757.  Will dir the track path. Select a track, and it will be loaded to the
  758.  cursor position or to the trackbuffer, depending on the MODE choice.
  759.  
  760.  ## SAVE TRACK ##
  761.  Will save the track from the cursor position or from the trackbuffer.
  762.  
  763.  ## LOAD PATTERN ##
  764.  Will dir the pattern path. Select a pattern, and it will be loaded to
  765.  the cursor position or to the patternbuffer.
  766.  
  767.  ## SAVE PATTERN ##
  768.  Will save the pattern from the cursor position or from the patternbuffer.
  769.  
  770.  ## MODE ##
  771.  Determines if the track/pattern will load/save to/from the buffer or
  772.  the cursor position.
  773.  
  774.  ## 1 ##
  775.  Goto Disk Op.1
  776.  
  777.  
  778.  AutoDir - If you set the autodir toggle on the setup screen
  779.            to on, Protracker will automatically dir the current
  780.            path when you enter the disk op. screen and after you've
  781.            saved/renamed/deleted something.
  782.  
  783.  AutoExit - When this toggle is on Protracker will exit from
  784.             disk op. when loading a song/module/track or pattern.
  785.  
  786.  
  787.  
  788.                 PLST
  789.                 ----
  790.  The PLST is fairly simple to use. Listed here are all the samples in
  791.  your Presetlist and their lengths. Just click on a name, and Protracker
  792.  will ask for a disk called ST-01 through to ST-FF. Insert it, and the
  793.  chosen sample will be loaded to the current sample displayed at the
  794.  left of the screen. Use the up/down arrow keys to move up and down in the
  795.  PresetList. If you press shift or the right mousebutton, the PLST will
  796.  move 10 presets at a time.
  797.  
  798.  At the top the PLST shows the total number of samples from the selected
  799.  sounddisks. There are a few PLST gadgets:
  800.  
  801.  ## CLEAR ##
  802.  Will clear all the sounddisk names you have entered, and display the whole
  803.  PresetList.
  804.  
  805.  ## MOUNTL(IST) ##
  806.  Will search your drives for disks called ST-**, and put the names into
  807.  the ST-__ gadgets. ST-00 will not be mounted.
  808.  
  809.  ## ST-__ ##
  810.  There are three ST-__ gadgets where you can enter the numbers of the
  811.  sounddisks you want to display in the PLST. Only the presets from the
  812.  selected sounddisks will be shown. If you clear all gadgets (by pressing
  813.  return or right mousebutton), or press "Clear", the PLST will revert
  814.  to show all presets.
  815.  
  816.  ## T(OP) ##
  817.  Will put you at the top of the preset-list.Holding the right mousebutton
  818.  will put you at the previous character in the preset-list.
  819.  
  820.  ## B(OTTOM) ##
  821.  Will put you at the bottom of the preset-list.Holding the right mousebutton
  822.  will put you at the next character in the preset-list.
  823.  
  824.  ## EXIT ##
  825.  There are 2 exitgadgets in this version. I didn't know what to change the
  826.  other exitgadget to.
  827.  
  828.  Holding shift while pressing a key will put you in the list at the
  829.  corresponding position.
  830.  
  831.  
  832.                 PRESET ED
  833.                 ---------
  834.  The preset editor is used for sorting and catalogueing your samples. All
  835.  samples for use with Protracker should be on disks called "ST-01" to
  836.  "ST-FF". When adding a disk to the presetlist, only these disks are
  837.  recognized.
  838.  
  839.  Harddisk owners may want to add a directory. e.g. You've got a directory
  840.  called "Supersamples", and you want to use the samples on PT... Simple.
  841.  Assign "Supersamples" to ST-13 or whatever. In the box with "Disk:"
  842.  and ST-__ in it, enter ST-13. Now enter "DHX:supersamples" in the
  843.  path box and press "add path".
  844.  
  845.  The path will be added as ST-13 in your presetlist, so everytime you need
  846.  a sample from ST-13, it will be loaded from "Supersamples" instead. Simple?
  847.  
  848.  Editing
  849.  --------
  850.  To edit a preset, simply click on it. Use the arrowkeys to move left/right.
  851.  When moving up and down in the presetlist, use shift or the right mouse-
  852.  button to speed it up a bit.
  853.  
  854.  ## ADD PATH ##
  855.  Will add the current path to the presetlist. infofiles will not be added.
  856.  Samplenames can only be 15 chars long.
  857.  
  858.  ## INSERT PRESET ##
  859.  Will create a new preset. Enter the data for the sample, and it will be
  860.  added to the presetlist.
  861.  
  862.  ## DELETE PRESET ##
  863.  Will delete the wanted preset from the presetlist.
  864.  
  865.  ## DELETE DISK ##
  866.  Will delete the disknumber set in the "Disk:" box.
  867.  
  868.  ## PATH ##
  869.  This is where you enter the path to be added from. It can be up to 31
  870.  characters long.
  871.  
  872.  ## DISK ##
  873.  This is the disk (or HD-dir) that's being added from (or deleted).
  874.  
  875.  ## PRESETS ##
  876.  This is the current number of presets in the presetlist.
  877.  
  878.  ## CLEAR PLST ##
  879.  Will clear all the presets.
  880.  
  881.  ## LOAD PLST ##
  882.  Will load the presetlist from a file called "PLST". This file should be
  883.  placed in the PTdir (See setup2).
  884.  
  885.  ## SAVE PLST ###
  886.  Will save the presetlist as a file called "PLST" to the current PTdir.
  887.  
  888.  ## PRINT PLST ##
  889.  Will print the presetlist to the current print path, shown on the
  890.  setup-screen.
  891.  
  892.  ## PLST ##
  893.  Will go to the PLST-screen!
  894.  
  895.  ## T(OP) ##
  896.  Will put you at the top of the preset-list.Holding the right mousebutton
  897.  will put you at the previous character in the preset-list.
  898.  
  899.  ## B(OTTOM) ##
  900.  Will put you at the bottom of the preset-list.Holding the right mousebutton
  901.  will put you at the next character in the preset-list.
  902.  
  903.  Holding shift while pressing a key will put you in the list at the
  904.  corresponding position.
  905.  
  906.  
  907.                 SAMPLER
  908.                 -------
  909.  Editing
  910.  -------
  911.  When editing a sample, use the mouse to set the cursorline and to mark
  912.  ranges.
  913.  
  914.  ## WAVEFORM ##
  915.  Will play the full sample with loops.
  916.  
  917.  ## DISPLAY ##
  918.  Will play the part of the sample being shown on screen.
  919.  
  920.  ## RANGE ##
  921.  Will play the marked range.
  922.  
  923.  ## STOP ##
  924.  Will stop all playing of samples.
  925.  
  926.  ## SHOW RANGE ##
  927.  Will magnify the current range and display it.
  928.  
  929.  ## SHOW ALL ##
  930.  Will display the whole sample.
  931.  
  932.  ## BEG ##
  933.  Will put the cursorline at the beginning of the sample.
  934.  
  935.  ## END ##
  936.  Will put the cursorline at the end of the sample.
  937.  
  938.  ## SWAP BUFF(ER) ##
  939.  The swap the current sample with the copy-buffer.
  940.  
  941.  ## ZOOM OUT ##
  942.  Will show double the range you are displaying.
  943.  
  944.  ## RANGE ALL ##
  945.  Will range the part of the sample being displayed on screen.
  946.  
  947.  ## CUT ##
  948.  Will cut away the part of the sample that's marked.
  949.  
  950.  ## COPY ##
  951.  Will copy the marked range to the copy-buffer.
  952.  
  953.  ## PASTE ##
  954.  Will paste the copy-buffer into the current sample.
  955.  
  956.  
  957.  The volume box
  958.  --------------
  959.  Set the "FROM" and "TO" volume percentages by using the sliders,
  960.  or just type in any number you please (from 0 to 200) in the
  961.  percentage boxes to the right.
  962.  
  963.  ## NORMALIZE ##
  964.  Will find the highest volume settings possible (without clipping).
  965.  
  966.  ## CANCEL ##
  967.  Will exit the volume box.
  968.  
  969.  ## \ ##
  970.  Will set the percentages 100%-0%
  971.  
  972.  ## / ##
  973.  Will set the percentages 0%-100%
  974.  
  975.  ## - ##
  976.  Will set the percentages 100%-100%
  977.  
  978.  ## RAMP ##
  979.  Will ramp (calculate) the volume!
  980.  
  981.  ## TUNETONE ##
  982.  Will create a sinus sound, which you can tune your samples after.
  983.  See setup 2 help for details.
  984.  
  985.  ## SAMPLE ##
  986.  Will first enter the monitor screen. Now click right button to sample,
  987.  left to exit. The pointer will be green when there is diskactivity.
  988.  
  989.  ## NOTE ##
  990.  This is the note to sample on. Range is C-1 to B-3.
  991.  
  992.  ## RESAMPLE ##
  993.  Here's a step-by-step explanation:
  994.  
  995.  1. Turn on the tuning tone.
  996.  2. Use the keyboard to find what note it is. Use finetune if needed.
  997.  3. Enter the note in the "Note:" box to the right.
  998.  4. Press resample!
  999.  
  1000.  ## NOTE ##
  1001.  This is what note to resample to.
  1002.  
  1003.  ## DISP(LAY) ##
  1004.  This is the length of the part of the sample being shown on screen.
  1005.  
  1006.  ## LOOP ON/OFF ##
  1007.  This is for turning loops on/off without having to fiddle with the
  1008.  repeat and replen gadgets.
  1009.  
  1010.  ## EXIT ##
  1011.  Exits the sampler screen.
  1012.  
  1013.  
  1014.  
  1015.                 SETUP 1
  1016.                 -------
  1017.  The setup screens were provided so that PT users could set up their own
  1018.  personal environment. We hope we have satisfied most of you. You've got 8
  1019.  on/off toggles, a split keyboard editor, a color palette and lots
  1020.  more. Choose what you want, and use "Save Config" to save your environ-
  1021.  ment. On the next screen is a list of what will be saved in the config
  1022.  file.
  1023.  
  1024.  This will be saved in the config file:
  1025.  --------------------------------------
  1026.  Songs/Modules/Samples/Tracks/Patterns and Print paths, Colors, Keyrepeat
  1027.  Song/Module/Sample/Track/Pattern Savemode, The 24 On/Off toggles, Split
  1028.  Keyboard data, Keyrepeat, Accidental, The eight external dos commands, 
  1029.  Max PLST entries, Multikey channeltable, Effectmacros, CIA/VB timing
  1030.  Tempo&Speed, DMA wait and Tunetone+Volume.
  1031.  
  1032.  You can have up to 256 different config files. They will be saved
  1033.  as "PT.config-00", "PT.config-01" and so on. Set the confignumber
  1034.  in the "cnfig" box.
  1035.  
  1036.  ## LOAD CONFIG ##
  1037.  Will load the selected config file.
  1038.  
  1039.  ## SAVE CONFIG ##
  1040.  Will save the selected config file.
  1041.  
  1042.  ## RESET ALL ##
  1043.  Will set the original PT defaults and colors.
  1044.  
  1045.  ## MULTI ##
  1046.  This table is used with the multi keyboard option. The four numbers repre-
  1047.  sent what channel each channel will jump to next. 1-2, 2-3, 3-4 and so on.
  1048.  
  1049.  ## THE DOT ##
  1050.  The gadget with a dot and a textline can be used to execute dos commands.
  1051.  Each of the 8 commands can be up to 31 letters long. Pressing the dot will
  1052.  browse through the commands. Holding the right button and pressing it will
  1053.  execute the command. Note that PT needs the command "run" to execute the
  1054.  other commands. This is because of commodore's stupid programming of the
  1055.  dos library function "execute". Type "endcli" to go back to Protracker.
  1056.  
  1057.  ## THE COLOR PALETTE ##
  1058.  The color palette is simple to use. Just select a color, and use the R,
  1059.  G and B sliders to set the color.
  1060.  
  1061.  ## UNDO ##
  1062.  Will put back the latest change.
  1063.  
  1064.  ## CANCEL ##
  1065.  Will set the config colors.
  1066.  
  1067.  ## DEF(AULT) ##
  1068.  Will set the original ST colors.
  1069.  
  1070.  ## SPLIT ##
  1071.  You can set 4 splits on the keyboard, each with it's own sample, splitpoint
  1072.  and transpose. Just type in a sample number and select the key to split
  1073.  at by pressing the appropriate one.
  1074.  The transpose note for each split is the first note in that split-range.
  1075.  Notes below the first split will be played with the current sample.
  1076.  Split is great for recording drums, or for playing untuned samples in tune
  1077.  (use together with finetune).
  1078.  
  1079.  ## CLEAR ##
  1080.  Will clear the splits.
  1081.  
  1082.  ## KEYREP(EAT) ##
  1083.  The first number is the keyrepeat delay, and the second is the speed.
  1084.  
  1085.  ## ACCIDENTAL ##
  1086.  Simple enough, accidental allows you to select sharp (#) or flat (¡) notes.
  1087.  This will not be saved with the song!
  1088.  
  1089.  ## PRINT SONG ##
  1090.  Will print the song to the path shown below the "Print Song" gadget.
  1091.  The print path can be 31 chars long.
  1092.  
  1093.  ## SPLIT ON/OFF ##
  1094.  Toggles between normal and split keyboard.
  1095.  
  1096.  ## FILTER ON/OFF ##
  1097.  Toggles the audiofilter / PowerLED.
  1098.  (Not available on all Amigas)
  1099.  
  1100.  ## TRANS(POSE)DEL(ETE) ON/OFF ##
  1101.  When on, notes transposed out of range will be deleted.
  1102.  
  1103.  ## SHOWDEC(IMAL) ##
  1104.  When on, Freemem, Tunemem, and filelengths will be shown in decimal.
  1105.  
  1106.  ## AUTODIR ON/OFF ##
  1107.  When on, Protracker dirs the current directory path automatically.
  1108.  
  1109.  ## AUTOEXIT ON/OFF ##
  1110.  When on, Protracker will automatically exit from the file requester when
  1111.  loading a song,module,track or pattern.
  1112.  
  1113.  ## MOD. ONLY ON/OFF ##
  1114.  When on, Protracker will only show modules beginning with "mod.".
  1115.  
  1116.  ## MIDI ON/OFF ##
  1117.  Enables midi input (see midi help).
  1118.  
  1119.  ## 2 ##
  1120.  Will enter SETUP 2.
  1121.  
  1122.  
  1123.  
  1124.                 SETUP 2
  1125.                 -------
  1126.  
  1127.  ## TIMING ##
  1128.  We included this so that American  users also could enjoy Protracker,
  1129.  and wouldn't have to use sonix or any other terrible music program...
  1130.  
  1131.  You can choose between CIA or Vblank timing. Vblank is the timing-method
  1132.  soundtrackers have been using since the dawn of time, while CIA is a much
  1133.  better and accurate timing with the tempo measured in beats per minute.
  1134.  Using Vblank on NTSC amigas will cause the song to play 20% faster.
  1135.  With CIA, there's no difference.
  1136.  
  1137.  ## TEMPO ##
  1138.  This is where you set your default CIA timing tempo. Range: 32-255.
  1139.  
  1140.  ## SPEED ##
  1141.  This is where you set your default Vblank timing speed. Range: 01-FF.
  1142.  
  1143.  ## COPPER EDITOR ##
  1144.  The copper editor is for altering the colors of the VU-meters and the
  1145.  spectrum analyzer to your own liking. Select a color by clicking somewhere
  1146.  within the coppered stripe. Now use the R, G and B sliders to
  1147.  alter the color.
  1148.  
  1149.  ## SPREAD ##
  1150.  Will create an even gradient between the current color and the one you
  1151.  click on next.
  1152.  
  1153.  ## ARROWS ##
  1154.  Will rotate the whole copper stripe in the Y-axis (up/down).
  1155.  
  1156.  ## UNDO, CANCEL and DEF(AULT) ##
  1157.  Will work just like in the palette in SETUP 1.
  1158.  
  1159.  ## MODS ##
  1160.  This is where you set your default modules path.
  1161.  
  1162.  ## SONGS ##
  1163.  This is where you set your default songs path.
  1164.  
  1165.  ## SAMPL(ES) ##
  1166.  This is where you set your default sample path.
  1167.  
  1168.  ## PTDIR ##
  1169.  This is the path for the helpfile, the PLST and the PT configfile(s).
  1170.  
  1171.  ## MAX PLST ##
  1172.  This is the maximum number of presets in your presetlist.
  1173.  
  1174.  ## DMA WAIT ##
  1175.  Use this on fast amigas to slow down the DMA enough to not miss any notes.
  1176.  If you set a too low value, you will miss some of the low notes!
  1177.  If you set a too high value, everything will be slowed down.
  1178.  300 or a little less is ok on a normal A500 7.09 MHz (PAL).
  1179.  900 (approx.) is ok on an A3000 running at 25Mhz.
  1180.  
  1181.  ## TUNING TONE ##
  1182.  The tuning tone is for use with the sample editor. The note is what note
  1183.  to play the tuning tone at, and the number is the volume.
  1184.  
  1185.  ## COUNT IN ##
  1186.  doesn't work yet...Sorry!
  1187.  
  1188.  ## <- DEFAULT ##
  1189.  Will put back the default for everything in the middle column.
  1190.  
  1191.  ## OVERRIDE ##
  1192.  When on, PT will ignore any paths or disknames when loading a song
  1193.  or module. All the samples will be loaded from the current sample
  1194.  path.
  1195.  
  1196.  ## NOSAMPLES ##
  1197.  When on, PT won't load the samples when loading a song or module.
  1198.  
  1199.  ## BLANKZERO ##
  1200.  When on, PT won't show the first zero in the samplenumber.
  1201.  
  1202.  ## SHOW DIRS ##
  1203.  When on, directories will be shown in Disk Op.
  1204.  
  1205.  ## SHOW PUBL(IC) ##
  1206.  When on, PT will show all free memory, not just chip-mem.
  1207.  
  1208.  ## CUT TO BUFF(ER) ##
  1209.  When on, all samples cut in the sample editor will to put in the
  1210.  copy-buffer.
  1211.  
  1212.  ## LOAD LOOP ##
  1213.  When on, PT will load loops from IFF-samples.
  1214.  
  1215.  ## SYS(TEM) REQ(UESTS) ##
  1216.  allows you to turn the requests on/off.
  1217.  
  1218.  ## SALVAGE ##
  1219.  Doesn't work yet.
  1220.  
  1221.  ## 100 PATTERNS ##
  1222.  with this on, you will be able to have 100 patterns.
  1223.  
  1224.  ## SAVE ICONS ##
  1225.  When on, PT will save an icon together with the module.
  1226.  
  1227.  ## LOAD (PATTERN)NAMES ##
  1228.  When on, PT will try to load the patternnames with the module.
  1229.  
  1230.  ## SAVE (PATTERN)NAMES ##
  1231.  When on, PT will save patternnames with the module.
  1232.  
  1233.  ## LOAD PLST ##
  1234.  When on, PT will load the PLST when it starts.
  1235.  
  1236.  ## SCREEN ADJUST ##
  1237.  When on, PT will scroll the screen 16 pixels to the left.
  1238.  
  1239.  ## SAMPLEPAK ##
  1240.  allows you to pack samples as IFF or RAW.
  1241.  
  1242.  ## 1 ##
  1243.  Will enter SETUP 1.
  1244.  
  1245.  You can now have modules with 100 patterns. If you save a module with more
  1246.  than 64 patterns then M.K. in the moduleheader will be changed to M!K!
  1247.  
  1248.  
  1249.                  MIDI
  1250.                  ----
  1251.  Midi routines in Protracker 2.2 are still very limited. Midi in should
  1252.  work ok, though. To activate midi, you'll have to turn it on on the
  1253.  setup1 screen. Use the three upper octaves on your synthesizer to play
  1254.  notes. Some keys in the lowest octave can be used to play/stop/record etc.
  1255.  
  1256.  We might fix better midi support in later versions of Protracker, but so
  1257.  far, this is uncertain... Read the PT.ReadMe! file for more info.
  1258.  
  1259.  
  1260.  
  1261.                 EDIT OP.
  1262.                 --------
  1263.  
  1264.  The edit op. screens were just a handy way for us to implement all the new
  1265.  functions we had thought of. There are three screens, and you can browse
  1266.  through them by pressing the edit op.  gadget more than once, or select one
  1267.  by clicking on the numbers 1-3.
  1268.  
  1269.  To exit edit op., click on the gadget labeled "E" or press ESC.
  1270.  
  1271.  
  1272.  Edit op. Screen 1:
  1273.  
  1274.  ## TRANSPOSING ##
  1275.  
  1276.  What is transposing ?
  1277.  
  1278.  Transposing lets you shift the pitch of the notes up or down.
  1279.  E.g. Change a C-3 to a C#3.
  1280.  
  1281.  In comparison to other trackers, Protracker lets you transpose in just
  1282.  about every way you can imagine. You can transpose either the current
  1283.  sample or all the samples in a track or pattern.
  1284.  
  1285.  To the right of the title bar is a small box with the letter "S" or "A".
  1286.  
  1287.  S - Only the current sample will be transposed.
  1288.  A - All the samples from $00-$1F will be transposed. V1.1: Now bugfree!
  1289.  
  1290.  To toggle between the two, click on the edit op. title bar.
  1291.  
  1292.  If the setup toggle "TransDel" is on, all the notes transposed out of range
  1293.  (C-1 to B-3) will be deleted. If not, they will not be transposed.
  1294.  
  1295.  
  1296.  Edit op. screen 2: (Record)
  1297.  
  1298.  ## RECORD ##
  1299.  PATT - Record current pattern only.
  1300.  SONG - When recording, PT will move through the patterns in the
  1301.         song, just like normal play.
  1302.  
  1303.  ## QUANTIZE ##
  1304.  Will move the notes you record to every n'th slot. Entering 00 will
  1305.  turn off the quantizing, and the notes you play will always be
  1306.  inserted at the patternposition you are at. Entering 01 will quantize
  1307.  the notes the the nearest slot according to the speed. i.e. if you
  1308.  play a note after the first half has been played, it will be quantized
  1309.  to the slot below. Entering a value like 8 will quantize to every 8th
  1310.  note, and so on. Got that?
  1311.  
  1312.  ## METRO(NOME) ##
  1313.  The first number is the speed of the metronome, and the second is the
  1314.  channel to play it on. The Sample used for metronomes is always sample
  1315.  $1F. Load your own favourite metronome sample. The metronome will always
  1316.  be played at C-3, but you can still change the volume and loop values.
  1317.  To turn off the metronome, just set the speed or channel to 00.
  1318.  V2.1: The metronome has a master toggle, ALT+M.
  1319.  
  1320.  ## KEYS ##
  1321.  When MULTI, PT will jump to another channel after you play a note on the
  1322.  keyboard. This makes it possible to play two or more notes at the same
  1323.  time (very useful with midi). On the setup screen you can choose what
  1324.  channel to jump to after playing a note.
  1325.  
  1326.  
  1327.  Edit Op. screen 2: (Samples)
  1328.  
  1329.  To the right of the title bar is a small box with the letter "T", "P"
  1330.  or "S".
  1331.  
  1332.  T - Copy & Exchange apply to current track only.
  1333.  P - Copy & Exchange will affect the the whole pattern.
  1334.  S - Copy & Exchange will apply to the real samples in memory.
  1335.  
  1336.  To toggle between the two, click on the edit op. title bar.
  1337.  
  1338.  ## DELETE ##
  1339.  Will delete all notes with the current sample in current track or whole
  1340.  pattern.
  1341.  
  1342.  ## KILL ##
  1343.  Will kill the current sample. That is, remove it from memory and reset
  1344.  all sample settings. It will not be deleted from the track or pattern.
  1345.  You can also use the period (.) key on the numeric keyboard to invoke
  1346.  this function.
  1347.  
  1348.  ## EXCHGE (EXCHANGE) ##
  1349.  Will exchange the samplenumber shown in the "FROM" gadget with the sample-
  1350.  number in the "TO" gadget and vice versa. "T" or "P" selects track or
  1351.  pattern. "S" exchanges the samples.
  1352.  
  1353.  ## MOVE ##
  1354.  Will move the samplenumber shown in the "FROM" gadget to the sample-
  1355.  number in the "TO" gadget.
  1356.  
  1357.  
  1358.  Edit Op. screen 3: (Sample Editor)
  1359.  
  1360.  To the right of the title bar is a small box with the letter "H" or "C".
  1361.  
  1362.  H - Will halve the volume when mixing and echoing to avoid clipping.
  1363.  C - Will not halve the volume. The sample may be clipped.
  1364.  
  1365.  To toggle between the two, click on the edit op. title bar.
  1366.  
  1367.  ## MIX ##
  1368.  Will mix one sample with another. PT asks you which two samples to be
  1369.  mixed, and where to put the result.
  1370.  
  1371.  Holding the right button and pressing mix will mix the current sample with
  1372.  itself. You can offset the sample by setting a position in the "pos" gadg.
  1373.  If you set "mod" to a non-zero value, the sample will also be modulated.
  1374.  
  1375.  ## ECHO ##
  1376.  Will create a echo effect on the current sample. Use "pos" to set the
  1377.  delay time of the echo. If you want more room to echo in, just turn up
  1378.  the length of the sample.
  1379.  
  1380.  ## BOOST ##
  1381.  Will turn up the treble of the sample. Use this on hi-hats and snares!
  1382.  
  1383.  ## FILTER ##
  1384.  Will Delta-filter the sample. Use this on noisy basses.
  1385.  
  1386.  ## X-FADE ##
  1387.  Will crossfade the sample (mix with itself, backwards). Handy for looping
  1388.  samples that are hard to loop.
  1389.  
  1390.  ## BACKWD (Backwards) ##
  1391.  Will turn the sample backwards!
  1392.  
  1393.  ## UPSAMPLE ##
  1394.  Will remove every second byte of the sample, halving the length and
  1395.  shifting the pitch one octave up.
  1396.  
  1397.  ## DOWNSAMPLE ##
  1398.  Will double every byte of the sample, doubling the length, and shifting
  1399.  the pitch one octave down. If you downsample samples longer than $7FFE,
  1400.  you will lose the end of them.
  1401.  
  1402.  ## POS ##
  1403.  This is just an offset in the sample, used for a lot of things.This one
  1404.  has a numbergadget as well.Holding the right mousebutton while pressing
  1405.  the numbergadget will zero the value.
  1406.  
  1407.  ## MOD ##
  1408.  This is used for modulation. Press "MOD" to modulate the current sample.
  1409.  Holding the right button while pressing the numbergadget will zero the
  1410.  value.
  1411.  
  1412.  ## CUTBEG(INNING) ##
  1413.  Will chop the number of bytes set in the "POS" gadget off the beginning of
  1414.  the sample.
  1415.  
  1416.  ## FU (Fade Up) ##
  1417.  Will fade the volume from 0 to 100%. Use "POS" to select where in the
  1418.  sample to fade up to.
  1419.  
  1420.  ## FD (Fade Down) ##
  1421.  Will fade the volume from 100 to 0%. Use "POS" to select where in the
  1422.  sample to fade down from.
  1423.  
  1424.  ## VOL ##
  1425.  With this you can change the "real" volume of the sample. Just set a
  1426.  percentage and press "VOL".VOL has a numbergadget.Holding the right
  1427.  button while pressing it will set the value to 100%.
  1428.  
  1429.  ## CHORD ##
  1430.  Will put you in the Chord-maker.
  1431.  
  1432.  Edit Op.3 is now intended to be used with the new sample-editor. If a
  1433.  range is marked, some of the functions apply to the range only. If there's
  1434.  no range marked, the functions will affect the whole sample. You may also
  1435.  set "POS" by clicking on the sample and setting the cursor-line.
  1436.  
  1437.  
  1438.                 Chord-maker
  1439.                 -----------
  1440.  
  1441.  ## Chord ##
  1442.  Will make the chord, using the current sample and the notes chosen, and the
  1443.  chord will be put in the current sample or a free sample,depending on your
  1444.  choice (see below)
  1445.  
  1446.  ## Reset ##
  1447.  will reset the notes and the length
  1448.  
  1449.  ## Undo ##
  1450.  will undo the last change. (apart from multiple arrow up/down)
  1451.  
  1452.  ## Length ##
  1453.  will set the length to the maximum value, depending on the length of the
  1454.  original sample and the notes you choose.This will ofcourse set the ':'
  1455.  after the 4 lengthdigits (see below)
  1456.  Holding the right mousebutton will set the length to the minimum depending
  1457.  on the notes chosen. '.' will be shown after the 4 digits. Mixing with the
  1458.  minimum length will make the sample as long as the shortest sample of the 4
  1459.  resampled notes.
  1460.  
  1461.  ## Major ##
  1462.  will set a major chord, depending on the basenote.
  1463.  
  1464.  ## Minor ##
  1465.  will set a minor chord, depending on the basenote.
  1466.  
  1467.  ## Sus-4 ##
  1468.  will set a sus-4 chord, depending on the basenote
  1469.  
  1470.  ## Length string gadget ##
  1471.  will wait for you to enter a new length (not greater than the maxlength.
  1472.  If you want a longer sample then add more space after the mix has been done.)
  1473.  The ':' after the 4 digits shows that the samplelength is set to its maximum!
  1474.  
  1475.  ## Major7 ##
  1476.  will set a major7 chord, depending on the basenote.
  1477.  
  1478.  ## Minor7 ##
  1479.  will set a minor7 chord, depending on the basenote.
  1480.  
  1481.  ## Major6 ##
  1482.  will set a major6 chord, depending on the basenote.
  1483.  
  1484.  ## Minor6 ##
  1485.  will set a minor6 chord, depending on the basenote.
  1486.  
  1487.  ## 4 notegadgets ##
  1488.  The upper one is the basenote.If you press a gadget, PT will wait for you to
  1489.  press a note.Holding the right mousebutton will reset the note
  1490.  
  1491.  ## 4 Up/Down gadgets ##
  1492.  will add/sub 1 halfnote from the current note.Holding right button will
  1493.  add/sub 1 octave.You can reset the note by adding past B-3.
  1494.  
  1495.  ## The 4 rightmost gadgets ##
  1496.  works just like the edit op gadgets. 1,2,3 takes you to the corresponding
  1497.  edit option, and E exits
  1498.  
  1499.  ## The statusline ##
  1500.  pressing the upper line will toggle between New or Old sample:
  1501.  If N, then PT will search for an free sample to put the result.
  1502.  If O, then PT will put the result on the current sample, overwriting the
  1503.  original sample
  1504.  
  1505. Note1!
  1506. ------
  1507. This version of PT resets repeat and replen. PT also puts a '!' last in the
  1508. samplename to show you that this is a chord sample.The '!' is for you to see
  1509. where the destination-sample has gone,it has nothing to do with the program.
  1510. You can take the '!' away and rename the sample to ...-major , ...-minor etc
  1511. for instance.
  1512.  
  1513. Note2!
  1514. ------
  1515. The chosen option on the statusline in edit op. 3 ,H(alve) or C(lip)
  1516. will affect the chord resampling and mixing!
  1517.  
  1518.  
  1519.                 Position-Editor
  1520.                 ---------------
  1521.  
  1522.  Press 'POS' on the mainscreen to get to the Position-Editor.
  1523.  All the gadgets should be well known, pressing the big gadget at the
  1524.  top will stop the song. Keyboard input works too,Left Alt,Left Amiga,space
  1525.  and the cursor up/down arrows.You can use the Position,pattern and length
  1526.  gadgets on the main screen, or click in the list to alter the current
  1527.  pattern or to enter a name to each pattern if you'd like to.
  1528.  The Patternnames will be loaded/saved if you have the corresponding toggles
  1529.  ON (load names,save names). The files will have the mod. exchanged to mod!
  1530.  just to distuingish them from the real modules. The patternnames will be
  1531.  cleared if you choose clear song or clear all.Another way is to click on
  1532.  each name you'd like to clear and then press the right mouse button.
  1533.  Patternplay works a little different from in the mainscreen.The pattern
  1534.  shown on the edit-row(the current position) will be played instead of the
  1535.  pattern currently shown in the notedatawindow.
  1536.  
  1537.  HEY! The patternnames has no effect on the module, they are just to remind
  1538.  the musician of the contents of the patterns, eg. you can name the first
  1539.  three patterns to INTRO just to remind yourself that those three patterns
  1540.  are the intro to your tune!
  1541.  
  1542.  
  1543.                 EFFECT COMMANDS
  1544.                 ---------------
  1545.  
  1546.  Effect commands on Protracker should
  1547.  be compatible with all other trackers.
  1548.  
  1549.  0 - None/Arpeggio      8 - * NOT USED *
  1550.  1 - Portamento Up      9 - SampleOffset
  1551.  2 - Portamento Down    A - VolumeSlide
  1552.  3 - TonePortamento     B - PositionJump
  1553.  4 - Vibrato            C - Set Volume
  1554.  5 - ToneP + VolSlide   D - PatternBreak
  1555.  6 - Vibra + VolSlide   E - Misc. Cmds
  1556.  7 - Tremolo            F - Set Speed
  1557.  
  1558.                 E - COMMANDS
  1559.                 ------------
  1560.  
  1561.  The E command has been altered to contain more commands than one.
  1562.  
  1563.  E0- Filter On/Off      E8- * NOT USED *
  1564.  E1- Fineslide Up       E9- Retrig Note
  1565.  E2- Fineslide Down     EA- FineVol Up
  1566.  E3- Glissando Control  EB- FineVol Down
  1567.  E4- Vibrato Control    EC- NoteCut
  1568.  E5- Set Finetune       ED- NoteDelay
  1569.  E6- Patternloop        EE- PatternDelay
  1570.  E7- Tremolo Control    EF- Invert Loop
  1571.  
  1572.  
  1573.  
  1574.  Cmd 0. Arpeggio [Range:$0-$F/$0-$F]
  1575.  -----------------------------------
  1576.  Usage: $0 + 1st halfnote add
  1577.            + 2nd halfnote add
  1578.  
  1579.  Arpeggio is used to simulate chords. This is done by rapidly changing the
  1580.  pitch between 3(or 2) different notes. It sounds very noisy and grainy on
  1581.  most samples, but ok on monotone ones.
  1582.  
  1583.  Example: C-300047  C-major chord: (C+E+G  or C+4+7 halfnotes)
  1584.  
  1585.           C-300037  C-minor chord: (C+D#+G or C+3+7 halfnotes)
  1586.  
  1587.  
  1588.  
  1589.  Cmd 1. Portamento up [Speed:$00-$FF]
  1590.  ------------------------------------
  1591.  Usage: $1 + portamento speed
  1592.  
  1593.  Portamento up will simply slide the sample pitch up. You can NOT slide
  1594.  higher than B-3! (Period 113)
  1595.  
  1596.  Example: C-300103  1 is the command, 3 is the portamentospeed.
  1597.  
  1598.  NOTE: The portamento will be called as many times as the speed of the song.
  1599.  This means that you'll sometimes have trouble sliding accuratly. If you
  1600.  change the speed without changing the sliderates, it will sound bad...
  1601.  
  1602.  
  1603.  
  1604.  Cmd 2. Portamento down [Speed:$00-FF]
  1605.  -------------------------------------
  1606.  Usage: $2 + portamento speed
  1607.  
  1608.  Just like command 1, except that this one slides the pitch down instead.
  1609.  (Adds to the period).
  1610.  
  1611.  You can NOT slide lower than C-1! (Period 856)
  1612.  
  1613.  Example: C-300203  2 is the command, 3 is the portamentospeed.
  1614.  
  1615.  
  1616.  
  1617.  Cmd 3. Tone-portamento [Speed:$00-$FF]
  1618.  --------------------------------------
  1619.  Usage: Dest-note + $3 + slidespeed
  1620.  
  1621.  This command will automatically slide from the old note to the new.
  1622.  You don't have to worry about which direction to slide, you need only set
  1623.  the slide speed. To keep on sliding, just select the command $3 + 00.
  1624.  
  1625.  Example: A-200000  First play a note.
  1626.           C-300305  C-3 is the note to slide to, 3 the command,
  1627.                     and 5 the speed.
  1628.  
  1629.  
  1630.  
  1631.  Cmd 4. Vibrato [Rate:$0-$F,Dpth:$0-$F]
  1632.  --------------------------------------
  1633.  Usage: $4 + vibratorate + vibratodepth
  1634.  
  1635.  Example: C-300481  4 is the command, 8 is the speed of the vibrato,
  1636.                     and 1 is the depth of the vibrato.
  1637.  
  1638.  To keep on vibrating, just select the command $4 + 00. To change the
  1639.  vibrato, you can alter the rate, depth or both. Use command E4- to
  1640.  change the vibrato-waveform.
  1641.  
  1642.  
  1643.  
  1644.  Cmd 5. ToneP + Volsl [Spd:$0-$F/$0-$F]
  1645.  --------------------------------------
  1646.  Usage: $5 + upspeed + downspeed
  1647.  
  1648.  This command will continue the current toneportamento and slide the volume
  1649.  at the same time. Compatible with Noisetracker 2.0.
  1650.  
  1651.  Example: C-300503  3 is the speed to turn the volume down.
  1652.  
  1653.           C-300540  4 is the speed to slide it up.
  1654.  
  1655.  
  1656.  
  1657.  Cmd 6. Vibra + Volsl [Spd:$0-$F/$0-$F]
  1658.  --------------------------------------
  1659.  Usage: $6 + upspeed + downspeed
  1660.  
  1661.  This command will continue the current vibrato and slide the volume at the
  1662.  same time. Compatible with Noisetracker 2.0.
  1663.  
  1664.  Example: C-300605  5 is the speed to turn the volume down.
  1665.  
  1666.           C-300640  4 is the speed to slide it up.
  1667.  
  1668.  
  1669.  
  1670.  Cmd 7. Tremolo [Rate:$0-$F,Dpth:$0-$F]
  1671.  --------------------------------------
  1672.  Usage: $7 + tremolorate + tremolodepth
  1673.  
  1674.  Tremolo vibrates the volume.
  1675.  
  1676.  Example: C-300794  7 is the command, 9 is the speed of the tremolo,
  1677.                     and 4 is the depth of the tremolo.
  1678.  
  1679.  To keep on tremoling, just select the command $7 + 00. To change the
  1680.  tremolo, you can alter the rate, depth or both. Use command E7- to
  1681.  change the tremolo-waveform.
  1682.  
  1683.  
  1684.  
  1685.  Cmd 9. Set SampleOffset [Offs:$00-$FF]
  1686.  --------------------------------------
  1687.  Usage: $9 + Sampleoffset
  1688.  
  1689.  This command will play from a chosen position in the sample, and not from
  1690.  the beginning. The two numbers equal the two first numbers in the length
  1691.  of the sample. Handy for speech samples.
  1692.  
  1693.  Example: C-300923  Play sample from offset $2300.
  1694.  
  1695.  
  1696.  
  1697.  Cmd A. Volumeslide [Speed:$0-$F/$0-$F]
  1698.  --------------------------------------
  1699.  Usage: $A + upspeed + downspeed
  1700.  
  1701.  Example: C-300A05  5 is the speed to turn the volume down.
  1702.  
  1703.           C-300A40  4 is the speed to slide it up.
  1704.  
  1705.  NOTE: The slide will be called as many times as the speed of the song.
  1706.  The slower the song, the more the volume will be changed on each note.
  1707.  
  1708.  
  1709.  
  1710.  Cmd B. Position-jump [Pos:$00-$7F]
  1711.  ----------------------------------
  1712.  Usage: $B + position to continue at
  1713.  
  1714.  Example: C-300B01  B is the command, 1 is the position to
  1715.                     restart the song at.
  1716.  
  1717.  This command will also perform a pattern-break (see 2 pages below).
  1718.  
  1719.  You can use this command instead of restart as on Noisetracker, but you
  1720.  must enter the position in hex!
  1721.  
  1722.  
  1723.  
  1724.  Cmd C. Set volume [Volume:$00-$40]
  1725.  ----------------------------------
  1726.  Usage: $C + new volume
  1727.  
  1728.  Well, this old familiar command will set the current volume to your own
  1729.  selected. The highest volume is $40. All volumes are represented in hex.
  1730.  (Programmers do it in hex, you know!)
  1731.  
  1732.  Example: C-300C10  C is the command, 10 is the volume (16 decimal).
  1733.  
  1734.  
  1735.  
  1736.  Cmd D. Pattern-break [Pattern-pos:00-63, decimal]
  1737.  -------------------------------------------------
  1738.  Usage: $D + pattern-position
  1739.  
  1740.  This command just jumps to the next song-position, and continues play
  1741.  from the patternposition you specify.
  1742.  
  1743.  Example: C-300D00  Jump to the next song-position and continue play
  1744.                     from patternposition 00.
  1745.       Or: C-300D32  Jump to the next song-position and continue play
  1746.                     from patternposition 32 instead.
  1747.  
  1748.  
  1749.  
  1750.  Cmd E0. Set filter [Range:$0-$1]
  1751.  --------------------------------
  1752.  Usage: $E0 + filter-status
  1753.  
  1754.  This command jerks around with the sound-filter on some A500 + A2000.
  1755.  All other Amiga-users should keep out of playing around with it.
  1756.  
  1757.  Example: C-300E01  disconnects filter (turns power LED off)
  1758.  
  1759.           C-300E00  connects filter (turns power LED on)
  1760.  
  1761.  
  1762.  
  1763.  Cmd E1. Fineslide up [Range:$0-$F]
  1764.  ----------------------------------
  1765.  Usage: $E1 + value
  1766.  
  1767.  This command works just like the normal portamento up, except that
  1768.  it only slides up once. It does not continue sliding during the length
  1769.  of the note.
  1770.  
  1771.  Example: C-300E11  Slide up 1 at the beginning of the note.
  1772.  
  1773.  (Great for creating chorus effects)
  1774.  
  1775.  
  1776.  
  1777.  Cmd E2. Fineslide down [Range:$0-$F]
  1778.  ------------------------------------
  1779.  Usage: $E2 + value
  1780.  
  1781.  This command works just like the normal portamento down, except that
  1782.  it only slides down once. It does not continue sliding during the length
  1783.  of the note.
  1784.  
  1785.  Example: C-300E26  Slide up 6 at the beginning of the note.
  1786.  
  1787.  
  1788.  
  1789.  Cmd E3. Glissando Ctrl [Range:$0-$1]
  1790.  ------------------------------------
  1791.  Usage: $E3 + Glissando-Status
  1792.  
  1793.  Glissando must be used with the tone-portamento command. When glissando is
  1794.  activated, toneportamento will slide a halfnote at a time, instead of a
  1795.  straight slide.
  1796.  
  1797.  Example: C-300E31  Turn Glissando on.
  1798.  
  1799.           C-300E30  Turn Glissando off.
  1800.  
  1801.  
  1802.  
  1803.  Cmd E4. Set vibrato waveform [Range:$0-$3]
  1804.  ------------------------------------------
  1805.  Usage: $E4 + vibrato-waveform
  1806.  
  1807.  Example: C-300E40  Set sine(default)
  1808.                E44  Don't retrig WF
  1809.           C-300E41  Set Ramp Down
  1810.                E45  Don't retrig WF
  1811.           C-300E42  Set Squarewave
  1812.                E46  Don't retrig WF
  1813.           C-300E43  Set Random
  1814.                E47  Don't retrig WF
  1815.  
  1816.  
  1817.  
  1818.  Cmd E5. Set finetune [Range:$0-$F]
  1819.  ----------------------------------
  1820.  Usage: $E5 + finetune-value
  1821.  
  1822.  Example: C-300E51  Set finetune to 1.
  1823.  
  1824.  Use these tables to figure out the finetune-value.
  1825.  
  1826.  Finetune: +7 +6 +5 +4 +3 +2 +1  0
  1827.     Value:  7  6  5  4  3  2  1  0
  1828.  
  1829.  Finetune: -1 -2 -3 -4 -5 -6 -7 -8
  1830.     Value:  F  E  D  C  B  A  9  8
  1831.  
  1832.  
  1833.  
  1834.  Cmd E6. PatternLoop [Loops:$0-$F]
  1835.  ----------------------------------
  1836.  Usage: $E6 + number of loops
  1837.  
  1838.  This command will loop a part of a pattern.
  1839.  
  1840.  Example: C-300E60  Set loopstart.
  1841.  
  1842.           C-300E63  Jump to loop 3 times before playing on.
  1843.  
  1844.  
  1845.  
  1846.  Cmd E7. Set tremolo waveform [Range:$0-$3]
  1847.  ------------------------------------------
  1848.  Usage: $E7 + tremolo-waveform
  1849.  
  1850.  Example: C-300E70  Set sine(default)
  1851.                E74  Don't retrig WF
  1852.           C-300E71  Set Ramp Down
  1853.                E75  Don't retrig WF
  1854.           C-300E72  Set Squarewave
  1855.                E76  Don't retrig WF
  1856.           C-300E73  Set Random
  1857.                E77  Don't retrig WF
  1858.  
  1859.  
  1860.  
  1861.  Cmd E9. Retrig note [Value:$0-$F]
  1862.  ---------------------------------
  1863.  Usage: $E9 + Tick to Retrig note at.
  1864.  
  1865.  This command will retrig the same note before playing the next. Where to
  1866.  retrig depends on the speed of the song. If you retrig with 1 in speed 6
  1867.  that note will be trigged 6 times in one note slot. Retrig on hi-hats!
  1868.  
  1869.  Example: C-300F06  Set speed to 6.
  1870.           C-300E93  Retrig at tick 3 out of 6.
  1871.  
  1872.  
  1873.  
  1874.  Cmd EA. FineVolsl up [Range:$0-$F]
  1875.  ----------------------------------
  1876.  Usage: $EA + value
  1877.  
  1878.  This command works just like the normal volumeslide up, except that
  1879.  it only slides up once. It does not continue sliding during the length
  1880.  of the note.
  1881.  
  1882.  Example: C-300EA3  Slide volume up 1 at the beginning of the note.
  1883.  
  1884.  
  1885.  
  1886.  Cmd EB. FineVolsl down [Range:$0-$F]
  1887.  ------------------------------------
  1888.  Usage: $EB + value
  1889.  
  1890.  This command works just like the normal volumeslide down, except that
  1891.  it only slides down once. It does not continue sliding during the length
  1892.  of the note.
  1893.  
  1894.  Example: C-300EB6  Slide volume down 6 at the beginning of the note.
  1895.  
  1896.  
  1897.  
  1898.  Cmd EC. Cut note [Value:$0-$F]
  1899.  ------------------------------
  1900.  Usage: $EC + Tick to cut note at.
  1901.  
  1902.  This command will cut the note at the selected tick, creating
  1903.  extremely short notes.
  1904.  
  1905.  Example: C-300F06  Set speed to 6.
  1906.           C-300EC3  Cut at tick 3 out of 6.
  1907.  
  1908.  Note that the note is not really cut, the volume is just turned down.
  1909.  
  1910.  
  1911.  
  1912.  Cmd ED. NoteDelay [Value:$0-$F]
  1913.  -------------------------------
  1914.  Usage: $ED + ticks to delay note.
  1915.  
  1916.  This command will delay the note to the selected tick.
  1917.  
  1918.  Example: C-300F06  Set speed to 6.
  1919.           C-300ED3  Play note at tick 3 out of 6.
  1920.  
  1921.  If you use ED0, the note will be delayed a little anyway.
  1922.  You can play the same note on two channels, delay one, and get a
  1923.  nice flanging effect.
  1924.  
  1925.  
  1926.  
  1927.  Cmd EE. PatternDelay [Notes:$0-$F]
  1928.  ----------------------------------
  1929.  Usage: $EE + notes to delay pattern.
  1930.  
  1931.  This command will delay the pattern the selected numbers of notes.
  1932.  
  1933.  Example: C-300EE8  Delay pattern 8 notes before playing on.
  1934.  
  1935.  All other effects are still active when the pattern is being delayed.
  1936.  
  1937.  
  1938.  
  1939.  Cmd EF. Invert Loop [Speed:$0-$F]
  1940.  ---------------------------------
  1941.  Usage: $EF + Invertspeed
  1942.  
  1943.  This command will need a short loop ($10,20,40,80 etc. bytes) to work.
  1944.  It will invert the loop byte by byte. Sounds better than funkrepeat...
  1945.  
  1946.  Example: C-300EF8 Set invspeed to 8.
  1947.  
  1948.  To turn off the inverting, set invspeed to 0, or press ctrl + Z.
  1949.  
  1950.  This effect will trash the sample, and will probably be removed in
  1951.  the next version.
  1952.  
  1953.  
  1954.  
  1955.  Cmd F. Set speed [Speed:$00-$FF]
  1956.  --------------------------------
  1957.  Usage: $F + speed
  1958.  
  1959.  This command will set the speed of the song.
  1960.  
  1961. Vblank: Range 01-FF - Normal timing
  1962.  
  1963.    CIA: Range 01-1F - Set vblank speeds
  1964.                       with CIA timing.
  1965.    CIA: Range 20-FF - Set BPM speeds,
  1966.                       range 32-255.
  1967.   Both: Range 00    - STOP song.
  1968.  
  1969.  
  1970.  
  1971.                 KEYBOARD
  1972.                 --------
  1973.  The keymap on Protracker is a standard US keymap. The font has been enhanced
  1974.  and redrawn a little, so you now have a lot more special characters than
  1975.  before. Remember to always use the left shift and alt, as the right ones
  1976.  are used for other things.
  1977.  
  1978.  High notekeys:  2 3   5 6 7   9 0   =
  1979.                 Q W E R T Y U I O P [ ]
  1980.  
  1981.  Low notekeys:    S D   G H J   L ;
  1982.                  Z X C V B N M , . /
  1983.  
  1984.  F1 - Choose lo octave(From C-1 to G-3)
  1985.  F2 - Choose hi octave(From C-2 to B-3)
  1986.  
  1987.       F3 - Cut   (sample)
  1988.       F4 - Copy  (sample)
  1989.       F5 - Paste (sample)
  1990.  
  1991.  shft+F3 - Cut track to buffer
  1992.  shft+F4 - Copy track to buffer
  1993.  shft+F5 - Paste track-buffer to track
  1994.  
  1995.   alt+F3 - Cut whole pattern to buffer
  1996.   alt+F4 - Copy whole pattern to buffer
  1997.   alt+F5 - Paste patt-buffer to pattern
  1998.  
  1999.  ctrl+F3 - Cut commands to buffer
  2000.  ctrl+F4 - Copy commands to buffer
  2001.  ctrl+F5 - Paste cmd-buffer to track
  2002.  
  2003.  F6 - Go to patternposition 0
  2004.  F7 - Go to patternposition 16
  2005.  F8 - Go to patternposition 32
  2006.  F9 - Go to patternposition 48
  2007.  F10- Go to patternposition 63
  2008.  
  2009.  shft+F6-F10 - Store current patternposition on selected F-key
  2010.   alt+F6-F10 - Play pattern from the stored patternposition
  2011.  ctrl+F6-F10 - Record from the stored patternposition
  2012.  
  2013. Esc - Exit DiskOp/EditOp/PLST/PsetEd/Setup/Help etc...
  2014.  
  2015.  shft+Return  - Insert blank note at cursorposition and move
  2016.                 the others down. Notes beyond patternposition
  2017.                 63 will be lost!
  2018.  shft+Bckspce - Delete note above cursorposition and move
  2019.                 the others up. You can NOT do this if you're
  2020.                 at patternposition 0!
  2021.  
  2022.  alt+Return    - As above, but with all 4 tracks
  2023.  alt+Backspace - As above, but with all 4 tracks
  2024.  
  2025.  ctrl+Return    - Push cmds one down
  2026.  ctrl+Backspace - Drag cmds one up
  2027.  
  2028.  ctrl+0-9 - Select how many slots PT will jump down each time
  2029.             you insert a note (this is only in Edit-mode)
  2030.  
  2031.   alt+cursor right - patternnumber up
  2032.   alt+cursor left  - patternnumber down
  2033.  shft+cursor right - song-position up
  2034.  shft+cursor left  - song-position down
  2035.  ctrl+cursor left  - samplenumber up
  2036.  ctrl+cursor right - samplenumber down
  2037.  
  2038.  BackwardsSingleQuote (The key over TAB, you know?) - Go to CLI
  2039.  
  2040.       Help - Go to help or plst screen
  2041.  shft+Help - Toggle between Help or PLST on Help key
  2042.  
  2043.  Space - Toggle between Stop/Edit-mode
  2044.  
  2045.  < (beside Z) - Kill DMA & Volumes to 0
  2046.   right Amiga - Play Pattern
  2047.     right Alt - Play Song
  2048.   right Shift - Record
  2049.     Caps Lock - Toggle Keyrepeat on/off
  2050.  
  2051.       Del - Delete note under cursor
  2052.   alt+Del - Delete command only
  2053.  shft+Del - Delete note and command
  2054.  
  2055.  On Numeric pad:
  2056.  
  2057.           0 - Select Sample $0
  2058.     1st row - Select Sample $1-$4
  2059.     2nd row - Select Sample $5-$8
  2060.     3rd row - Select Sample $9-$c
  2061.     4th row - Select Sample $d-$f
  2062.  Just Enter - Select Sample $10
  2063.  
  2064.  Holding Enter + the other keys, will select sample $11-$1F
  2065.  
  2066.  Period (.) - Kill current sample
  2067.  
  2068.  Left Amiga (Plus keys below) - Transposing like in Edit Op. Screen 1
  2069.  
  2070.    Sample/Track        Sample/Pattern
  2071.    ----------------------------------
  2072.    1 - Note Up         2 - Note Up
  2073.    Q - Note Down       W - Note Down
  2074.    A - Octave Up       S - Octave Up
  2075.    Z - Octave Down     X - Octave Down
  2076.  
  2077.    All/Track           All/Pattern
  2078.    -------------------------------
  2079.    3 - Note Up         4 - Note Up
  2080.    E - Note Down       R - Note Down
  2081.    D - Octave Up       F - Octave Up
  2082.    C - Octave Down     V - Octave Down
  2083.  
  2084.       Tab - Move cursor to next track
  2085.  Shft+Tab - Move cursor to prev track
  2086.  
  2087.  ctrl+A - Toggle channel on/off
  2088.  ctrl+B - Mark block
  2089.  ctrl+C - Copy block to buffer
  2090.  ctrl+D - Delete block, drag notes up
  2091.  ctrl+E - expand track
  2092.  ctrl+F - toggle filter on/off
  2093.  ctrl+G - Boost all samples
  2094.  ctrl+H - Transpose block up
  2095.  ctrl+I - Insert block, push notes down
  2096.  ctrl+J - Join-paste block
  2097.  ctrl+K - Kill to end of track
  2098.  ctrl+L - Transpose block down
  2099.  ctrl+M - Toggle multikeyboard on/off
  2100.  ctrl+N - Re-mark last block
  2101.  ctrl+O - Contract track
  2102.  ctrl+P - Paste block
  2103.  ctrl+Q - Unmute all channels
  2104.  ctrl+R - Restore F6-F10 positions
  2105.  ctrl+S - Toggle split keyboard on/off
  2106.  ctrl+T - swap tracks
  2107.  ctrl+U - undo last change
  2108.  ctrl+V - Filter all samples
  2109.  ctrl+W - Polyphonize block
  2110.  ctrl+X - Cut block to buffer
  2111.  ctrl+Y - Backwards block
  2112.  ctrl+Z - Restore Effects
  2113.  
  2114.  shft+0-9 - Store current command on selected key
  2115.   alt+0-9 - Insert command in current track
  2116.  
  2117.   alt+"\" - Copy command above cursor to current patternposition.
  2118.   alt+"=" - Copy command above cursor to current patternposition
  2119.             and add one to the value.
  2120.   alt+"-" - Copy command above cursor to current patternposition
  2121.             and subract one from the value.
  2122.  
  2123.   alt+A - Monitor/Start sampling
  2124.   alt+B - Boost sample
  2125.   alt+C - Toggle channel 3
  2126.   alt+D - Go to Disk Op.
  2127.   alt+E - Go to Edit Op.
  2128.   alt+F - Filter sample
  2129.   alt+I - Toggle AutoinsertEffect on/off
  2130.   alt+K - Delete current sample/track
  2131.   alt+M - Toggle metronome on/off
  2132.   alt+Q - Quit Protracker
  2133.   alt+R - Resample
  2134.   alt+S - Go to Sampler screen
  2135.   alt+T - Tuning Tone
  2136.   alt+V - Toggle channel 4
  2137.   alt+X - Toggle channel 2
  2138.   alt+Y - Save all samples
  2139.   alt+Z - Toggle channel 1
  2140.  
  2141.  alt+shift+M - Set metrochannel to current channel
  2142.  
  2143.       ' - Autoinsertmacro down
  2144.       # - Autoinsertmacro up (The key beside return)
  2145.       \ - Toggle keypad mode (dots!)
  2146.  Return - Step one note forward
  2147.  Backspc - Step one note backward
  2148.   Alt+any key on keypad - tune drumpad
  2149.  
  2150.  LeftAmiga+N - ScreenToBack
  2151.  LeftAmiga+M - ScreenToFront
  2152.  
  2153.              GENERAL INFO.
  2154.              -------------
  2155.  Making Music
  2156.  ------------
  2157.  Any piece of music written with Protracker is built up from patterns.
  2158.  Each pattern is built up from four tracks, one for each of the amiga's
  2159.  audiochannels.
  2160.  
  2161.  A pattern is 64 lines long. The magnified line is always the one you edit.
  2162.  If you need shorter patterns, use the patternbreak effect command.
  2163.  
  2164.  A track is built up like this:
  2165.  
  2166.      32  C-3 01 C20
  2167.      /   \_/ |/ \_/
  2168.     /    /   |    \
  2169.   Pos Note Sample Effect cmd.
  2170.  
  2171.  The C-3 is the note being played at patternposition 32. 01 is the sample-
  2172.  number, and the three last digits are the effect command, in this case, set
  2173.  volume to $20 (C-Command, 20-Value).
  2174.  
  2175.  Protracker holds a table with info about the sequence in which the patt-
  2176.  erns will be played. With the "Pos" gadget you determine your position in
  2177.  the table. With "Pattern" you define what pattern to play at that position.
  2178.  "Length" defines the total size of the table. The full sequence of Patterns
  2179.  is the Song. A song is built up from up to 64 different patterns, each
  2180.  being played at up to 128 different positions.
  2181.  
  2182.  The small gadgets labeled "I" and "D" are Insert and Delete. With them you
  2183.  can Insert or Delete a position from your song. The length of your song
  2184.  will be adjusted automatically. Remember that the length of your song
  2185.  always must be one more than the last position, since the first position
  2186.  is 0.
  2187.  
  2188.  The "Are you sure ?" requester
  2189.  ------------------------------
  2190.  In addition to the gadgets, you can use "Y" or Return for Yes,
  2191.  and "N" or ESC for No.
  2192.  
  2193.  The Clear requester
  2194.  -------------------
  2195.  In addition to the gadgets you can use "A" for All, "O" for Song, "S" for
  2196.  samples and "C" or ESC for Cancel.
  2197.  
  2198.  The text-input routine
  2199.  ----------------------
  2200.  Now this is really simple. Clicking on a textline will enable you to edit
  2201.  it. Some text lines are longer than they seem, so use the arrowkeys to
  2202.  scroll back and forth in the text. The text input mode is just like an
  2203.  ordinary text editor. You can use backspace, delete, space and such.
  2204.  In text-input mode you can also use the numeric pad for entering numbers.
  2205.  Pressing the right mousebutton will clear the textline and exit the editing.
  2206.  Use ESC or return to just exit.
  2207.  
  2208.  The numbergadgets
  2209.  -----------------
  2210.  Click on them and type in the value(Hex or Dec).ESC or return aborts.
  2211.  
  2212.  Passing arguments from Workbench/CLI
  2213.  ------------------------------------
  2214.  When starting from CLI, you can type a modulename with a pathname(optional)
  2215.  as an argument. The modulename will be added to the modulepath stored in
  2216.  the current config-file.
  2217.  E.g. If the modulepath is ST-00:modules, and you pass crap/mod.fake as an
  2218.  argument, then the module ST-00:modules/crap/mod.fake will be loaded.
  2219.  When starting from Workbench, you can click on a project icon twice and
  2220.  the selected module will be loaded(presuming that the icon's default tool
  2221.  is PT2.1A.The module will be loaded from the modulepath in the current
  2222.  config-file regardless of in which directory the moduleicon is located.
  2223.  That is, you can have all modules in a directory and the icons in another
  2224.  directory to prevent PT from loading all .info files into the file-list
  2225.  when you select LOAD MODULE.
  2226.  Pressing the moduleicon once, and holding shift while double-clicking on
  2227.  the PT2.1A icon also works as above.
  2228.  
  2229.  Tips 'n tricks
  2230.  --------------
  2231.  When inserting, pasting or join-pasting, hold down shift to keep the
  2232.  cursor from jumping to the end of the block. e.g. shft+ctrl+P
  2233.  
  2234.  Holding shift while pressing ctrl+K (kill to end of track) will kill to
  2235.  start of track instead.
  2236.  Holding shift while pressing ctrl+shift-a will solo the current channel.
  2237.  
  2238.  Use Esc or right mousebutton to exit from a lot of things.
  2239.  
  2240.  Effect tips
  2241.  -----------
  2242.  You can set the volume without playing a note. e.g. ---01000
  2243.  This will set the volume for sample 1 without trigging the note.
  2244.  
  2245.  Or try trigging the sample and sliding
  2246.  the volume down. e.g. C-301A08
  2247.                        ---01A08
  2248.                        ---01A08
  2249.  This will create a strange arpeggiato effect, like on "Cream of the earth"
  2250.  by Romeo Knight / RSI.
  2251.  
  2252.  
  2253.  Pointer Colors
  2254.  --------------
  2255.  
  2256.  Gray      - Nothin's happening.
  2257.  Yellow    - Playing song / pattern.
  2258.  Green     - Disk action.
  2259.  Blue      - Edit / record.
  2260.  Magenta   - Waiting for something (text, number or something else).
  2261.  Cyan      - Select entry or delete.
  2262.  Red       - Something went wrong.
  2263.  
  2264.  
  2265.  Drumpad
  2266.  -------
  2267.  Use backspace '\' to toggle modes. One or more dots will appear to
  2268.  the right of the freemem display.
  2269.  
  2270.  No dots: Normal keypad.
  2271.    1 dot: Drumpad.
  2272.   2 dots: Drumpad - Edit/Rec possible.
  2273.  
  2274.  Use Alt + keypad key to set note.
  2275.  
  2276.  
  2277. ***************************************************************************
  2278.  
  2279.  
  2280. Protracker V2.1A Effect Commands
  2281. ----------------------------------------------------------------------------
  2282. 0 - Normal play or Arpeggio             0xy : x-first halfnote add, y-second
  2283. 1 - Slide Up                            1xx : upspeed
  2284. 2 - Slide Down                          2xx : downspeed
  2285. 3 - Tone Portamento                     3xx : up/down speed
  2286. 4 - Vibrato                             4xy : x-speed,   y-depth
  2287. 5 - Tone Portamento + Volume Slide      5xy : x-upspeed, y-downspeed
  2288. 6 - Vibrato + Volume Slide              6xy : x-upspeed, y-downspeed
  2289. 7 - Tremolo                             7xy : x-speed,   y-depth
  2290. 8 - NOT USED
  2291. 9 - Set SampleOffset                    9xx : offset (23 -> 2300)
  2292. A - VolumeSlide                         Axy : x-upspeed, y-downspeed
  2293. B - Position Jump                       Bxx : songposition
  2294. C - Set Volume                          Cxx : volume, 00-40
  2295. D - Pattern Break                       Dxx : break position in next patt
  2296. E - E-Commands                          Exy : see below...
  2297. F - Set Speed                           Fxx : speed (00-1F) / tempo (20-FF)
  2298. ----------------------------------------------------------------------------
  2299. E0- Set Filter                          E0x : 0-filter on, 1-filter off
  2300. E1- FineSlide Up                        E1x : value
  2301. E2- FineSlide Down                      E2x : value
  2302. E3- Glissando Control                   E3x : 0-off, 1-on (use with tonep.)
  2303. E4- Set Vibrato Waveform                E4x : 0-sine, 1-ramp down, 2-square
  2304. E5- Set Loop                            E5x : set loop point
  2305. E6- Jump to Loop                        E6x : jump to loop, play x times
  2306. E7- Set Tremolo Waveform                E7x : 0-sine, 1-ramp down. 2-square
  2307. E8- NOT USED
  2308. E9- Retrig Note                         E9x : retrig from note + x vblanks
  2309. EA- Fine VolumeSlide Up                 EAx : add x to volume
  2310. EB- Fine VolumeSlide Down               EBx : subtract x from volume
  2311. EC- NoteCut                             ECx : cut from note + x vblanks
  2312. ED- NoteDelay                           EDx : delay note x vblanks
  2313. EE- PatternDelay                        EEx : delay pattern x notes
  2314. EF- Invert Loop                         EFx : speed
  2315. ----------------------------------------------------------------------------
  2316.  
  2317. Peter "CRAYON" Hanning /Mushroom Studios/Noxious
  2318.  
  2319.  
  2320. ***************************************************************************
  2321.  
  2322.  
  2323. Protracker 2.1A Song/Module Format:
  2324. -----------------------------------
  2325.  
  2326. Offset  Bytes  Description
  2327. ------  -----  -----------
  2328.    0     20    Songname. Remember to put trailing null bytes at the end...
  2329.  
  2330. Information for sample 1-31:
  2331.  
  2332. Offset  Bytes  Description
  2333. ------  -----  -----------
  2334.   20     22    Samplename for sample 1. Pad with null bytes.
  2335.   42      2    Samplelength for sample 1. Stored as number of words.
  2336.                Multiply by two to get real sample length in bytes.
  2337.   44      1    Lower four bits are the finetune value, stored as a signed
  2338.                four bit number. The upper four bits are not used, and
  2339.                should be set to zero.
  2340.                Value:  Finetune:
  2341.                  0        0
  2342.                  1       +1
  2343.                  2       +2
  2344.                  3       +3
  2345.                  4       +4
  2346.                  5       +5
  2347.                  6       +6
  2348.                  7       +7
  2349.                  8       -8
  2350.                  9       -7
  2351.                  A       -6
  2352.                  B       -5
  2353.                  C       -4
  2354.                  D       -3
  2355.                  E       -2
  2356.                  F       -1
  2357.  
  2358.   45      1    Volume for sample 1. Range is $00-$40, or 0-64 decimal.
  2359.   46      2    Repeat point for sample 1. Stored as number of words offset
  2360.                from start of sample. Multiply by two to get offset in bytes.
  2361.   48      2    Repeat Length for sample 1. Stored as number of words in
  2362.                loop. Multiply by two to get replen in bytes.
  2363.  
  2364. Information for the next 30 samples starts here. It's just like the info for
  2365. sample 1.
  2366.  
  2367. Offset  Bytes  Description
  2368. ------  -----  -----------
  2369.   50     30    Sample 2...
  2370.   80     30    Sample 3...
  2371.    .
  2372.    .
  2373.    .
  2374.  890     30    Sample 30...
  2375.  920     30    Sample 31...
  2376.  
  2377. Offset  Bytes  Description
  2378. ------  -----  -----------
  2379.  950      1    Songlength. Range is 1-128.
  2380.  951      1    Well... this little byte here is set to 127, so that old
  2381.                trackers will search through all patterns when loading.
  2382.                Noisetracker uses this byte for restart, but we don't.
  2383.  952    128    Song positions 0-127. Each hold a number from 0-63 that
  2384.                tells the tracker what pattern to play at that position.
  2385. 1080      4    The four letters "M.K." - This is something Mahoney & Kaktus
  2386.                inserted when they increased the number of samples from
  2387.                15 to 31. If it's not there, the module/song uses 15 samples
  2388.                or the text has been removed to make the module harder to
  2389.                rip. Startrekker puts "FLT4" or "FLT8" there instead.
  2390.  
  2391. Offset  Bytes  Description
  2392. ------  -----  -----------
  2393. 1084    1024   Data for pattern 00.
  2394.    .
  2395.    .
  2396.    .
  2397. xxxx  Number of patterns stored is equal to the highest patternnumber
  2398.       in the song position table (at offset 952-1079).
  2399.  
  2400. Each note is stored as 4 bytes, and all four notes at each position in
  2401. the pattern are stored after each other.
  2402.  
  2403. 00 -  chan1  chan2  chan3  chan4
  2404. 01 -  chan1  chan2  chan3  chan4
  2405. 02 -  chan1  chan2  chan3  chan4
  2406. etc.
  2407.  
  2408. Info for each note:
  2409.  
  2410.  _____byte 1_____   byte2_    _____byte 3_____   byte4_
  2411. /                \ /      \  /                \ /      \
  2412. 0000          0000-00000000  0000          0000-00000000
  2413.  
  2414. Upper four    12 bits for    Lower four    Effect command.
  2415. bits of sam-  note period.   bits of sam-
  2416. ple number.                  ple number.
  2417.  
  2418. Periodtable for Tuning 0, Normal
  2419.   C-1 to B-1 : 856,808,762,720,678,640,604,570,538,508,480,453
  2420.   C-2 to B-2 : 428,404,381,360,339,320,302,285,269,254,240,226
  2421.   C-3 to B-3 : 214,202,190,180,170,160,151,143,135,127,120,113
  2422.  
  2423. To determine what note to show, scan through the table until you find
  2424. the same period as the one stored in byte 1-2. Use the index to look
  2425. up in a notenames table.
  2426.  
  2427. This is the data stored in a normal song. A packed song starts with the
  2428. four letters "PACK", and then comes the packed data.
  2429.  
  2430. In a module, all the samples are stored right after the patterndata.
  2431. To determine where a sample starts and stops, you use the sampleinfo
  2432. structures in the beginning of the file (from offset 20). Take a look
  2433. at the mt_init routine in the playroutine, and you'll see just how it
  2434. is done.
  2435.  
  2436. Lars "ZAP" Hamre /Amiga Freelancers
  2437. Peter "CRAYON" Hanning /Mushroom Studios/Noxious
  2438.  
  2439.  
  2440. ***************************************************************************
  2441.  
  2442.  
  2443. Protracker CIA (Complex Interface Adapter) Timer Tempo Calculations:
  2444. --------------------------------------------------------------------
  2445. Fcolor                        = 4.43361825 MHz (PAL color carrier frequency)
  2446. CPU Clock   = Fcolor * 1.6    = 7.0937892  MHz
  2447. CIA Clock   = Cpu Clock / 10  = 709.37892  kHz
  2448. 50 Hz Timer = CIA Clock / 50  = 14187.5784
  2449. Tempo num.  = 50 Hz Timer*125 = 1773447
  2450.  
  2451. For NTSC: CPU Clock = 7.1590905 MHz --> Tempo num. = 1789773
  2452.  
  2453.  To calculate tempo we use the formula: TimerValue = 1773447 / Tempo
  2454.  The timer is only a word, so the available tempo range is 28-255 (++).
  2455.  Tempo 125 will give a normal 50 Hz timer (VBlank).
  2456.  
  2457.  A normal Protracker VBlank song tempo can be calculated as follows:
  2458.  We want to know the tempo in BPM (Beats Per Minute), or rather quarter-
  2459.  notes per minute. Four notes makes up a quarternote.
  2460.  First find interrupts per minute: 60 seconds * 50 per second = 3000
  2461.  Divide by interrupts per quarter note = 4 notes * speed
  2462.  This gives: Tempo = 3000/(4*speed)
  2463.  simplified: Tempo = 750/speed
  2464.  For a normal song in speed 6 this formula gives: 750/6 = 125 BPM
  2465.  
  2466.  Lars "ZAP" Hamre/Amiga Freelancers 1990
  2467.  
  2468.  
  2469. ***************************************************************************
  2470.  
  2471.  
  2472. ------------------------------------------------
  2473. Bugfixes and improvements from PT2.1A to PT2.2A:
  2474. ------------------------------------------------
  2475.  
  2476. - I have fixed the chip-mem bug from PT2.1A.(it didn't work with chipmem only)
  2477. - When Preset-ed screen was shown,you couldn't use the gadgets on the lower
  2478.   part of the main- or sample-screen.
  2479. - When autoexitdirtoggle was off,PT didn't change the songname when you loaded
  2480.   a new song/module until you exit from disk op.
  2481. - If you resampled a sample with big difference between the tunetone and the
  2482.   resampletone then the new length was incorrectly computed.
  2483. - If you ran out of memory when allocating crunchbuffersize then ... software
  2484.   failure! This should work just fine now.
  2485. - If you loaded a sample with a '.' in the samplename then PT set the length
  2486.   incorrectly in some cases (see below)
  2487. - Save module should work fine now.(another nasty bug is swept away!)
  2488. - The Sampler works fine on ks2.0 (This version tests diskactivity before
  2489.   sampling, PT1.3 doesn't!)
  2490.   ***********************************************************************
  2491.   * Thanks to Matrix/LSD for sending the working piece of source to me! *
  2492.   ***********************************************************************
  2493. - The timer is updated when you play a song while jumping out to Workbench.
  2494. - The Loopsprites are working fine with screenadjust.
  2495. - Stepplay works fine now. Amiga+Backspace is gone though.
  2496. - MIDI in functions are working now, I hope!
  2497. - Inputhandler debugged a little.
  2498. - ShowFreeDiskGadget debugged (again). Before it showed 2 sectors too much.
  2499. - If you pressed the deletefile gadget and then pressed a directoryname in
  2500.   the list then the dir was added to the path but the directory wasn't opened.
  2501.   This is now fixed.
  2502. - PrintSong now prints the patternlist with decimal values. It prints all
  2503.   patterns.(Older versions of PT missed to print the highest pattern)
  2504. - I have implemented a chord maker.
  2505. - I have implemented e Position-Editor.
  2506. - On request, I have made ''multitasking'' like in PT1.3.
  2507. - ProTracker has it's own screen. When the PT screen is in front of all other
  2508.   screens, PT will wake up.
  2509. - The browse function is modified to act like PT1.3. It shows the current
  2510.   devices and disknames.
  2511. - If you hold the right mousebutton while pressing the browsegadget a disklist
  2512.   will pop up showing all the device- and disknames from the browsegadget in
  2513.   the filenamewindow. Pressing a name will autoload that directory.
  2514. - If you press LeftShift+any key 0-9 a-z while in DiskOp,  PLST or PresetEd,
  2515.   PT will move you to the position in the list with a name beginning with the
  2516.   corresponding character.
  2517. - If you use MIDI I've added two new keys. A-2 and B-2 on the Synthkeyboard
  2518.   are used as SampleNumber Up/Down! I have also Transposed the MIDInotes input
  2519.   one octave down (because Dolphin has a small keyboard and couldn't access
  2520.   the upper octave,C#3 - B-3).
  2521. - I have added a SaveExecutable option.
  2522. - 9 new toggles.
  2523.  
  2524. ***************************************************************************
  2525.  
  2526.  
  2527. -----------------------------------
  2528. -*-     PT2.2A  Beta version    -*-
  2529. -----------------------------------
  2530.         22/6 1992
  2531.  
  2532. **************************************************************************
  2533.  
  2534. Ok, here it is at last, the new version of ProTracker2.2A. On this disk
  2535. is a betaversion, which all of you will test for bugs etc. and the final
  2536. version will be released in some weeks(depending on the bugs?).
  2537.  
  2538. At the time being, I have no plans to enhance this version of ProTracker.
  2539. I will (maybe) start coding a Tracker of my own from scratch. On the other
  2540. side,I have got some inspiration to write some demo-routines for a coming
  2541. Noxious demo, but lazy as I am it'll take some time. During the last two
  2542. weeks I have been coding some music and diskloading stuff for a coming
  2543. Shoot'em'up game.
  2544.  
  2545. **************************************************************************
  2546.  
  2547. Bugs fixed:
  2548. --------------------------------------------------------------------------
  2549.  
  2550. I have fixed the chip-mem bug from PT2.1A. (it didn't work with chip-mem only)
  2551.  
  2552. When Preset-ed screen was shown,you couldn't use the gadgets on the lower
  2553. part of the main- or sample-screen.
  2554.  
  2555. When autoexitdirtoggle was off, PT didn't change the songname when you loaded
  2556. a new song/module until you exit from disk op.
  2557.  
  2558. If you resampled a sample with big difference between the tunetone and the
  2559. resampletone then the new length was incorrectly computed.
  2560.  
  2561. If you ran out of memory when allocating crunchbuffersize then ... software
  2562. failure! This should work just fine now.
  2563.  
  2564. If you loaded a sample with a '.' in the samplename then PT set the length
  2565. incorrectly in some cases (see below)
  2566.  
  2567. Save module should work fine now.(another nasty bug is swept away!)
  2568.  
  2569. The Sampler works fine on ks2.0 (This version tests diskactivity before
  2570. sampling, PT1.3 doesn't!)
  2571.  ***********************************************************************
  2572.  * Thanks to Matrix/LSD for sending the working piece of source to me! *
  2573.  ***********************************************************************
  2574.  
  2575. The timer is updated when you play a song while jumping out to Workbench.
  2576.  
  2577. The Loopsprites are working fine with screenadjust.
  2578.  
  2579. Stepplay works fine now. Amiga+Backspace is gone though.
  2580.  
  2581. MIDI in functions are working now, I hope!
  2582.  
  2583. Inputhandler debugged a little.
  2584.  
  2585. ShowFreeDiskGadget debugged (again). Before it showed 2 sectors too much.
  2586.  
  2587. If you pressed the deletefile gadget and then pressed a directoryname in
  2588. the list then the dir was added to the path but the directory wasn't opened.
  2589. This is now fixed.
  2590.  
  2591. PrintSong now prints the patternlist with decimal values. It prints all
  2592. patterns.(Older versions of PT missed to print the highest pattern)
  2593.  
  2594.  
  2595. **************************************************************************
  2596. News News News News News News News News News News News News News News News
  2597. **************************************************************************
  2598.  
  2599.  
  2600. I have on request from Sun/Dreamdealers implemented a chord maker.
  2601. Just press chord in edit op. 3 and you will see a new window for making chords.
  2602.  
  2603.  
  2604. The gadgets:
  2605. ------------
  2606.  
  2607. * Chord
  2608. will make the chord, using the current sample and the notes chosen, and the
  2609. chord will be put in the current sample or a free sample,depending on your
  2610. choice (see below)
  2611.  
  2612. * Reset
  2613. will reset the notes and the length
  2614.  
  2615. * Undo
  2616. will undo the last change. (apart from multiple arrow up/down)
  2617.  
  2618. * Length
  2619. will set the length to the maximum value, depending on the length of the
  2620. original sample and the notes you choose.This will ofcourse set the ':'
  2621. after the 4 lengthdigits (see below)
  2622. Holding the right mousebutton will set the length to the minimum depending
  2623. on the notes chosen. '.' will be shown after the 4 digits. Mixing with the
  2624. minimum length will make the sample as long as the shortest sample of the 4
  2625. resampled notes.
  2626.  
  2627. * Major
  2628. will set a major chord, depending on the basenote.
  2629.  
  2630. * Minor
  2631. will set a minor chord, depending on the basenote.
  2632.  
  2633. * Sus-4
  2634. will set a sus-4 chord, depending on the basenote
  2635.  
  2636. * Length string gadget
  2637. will wait for you to enter a new length (not greater than the maxlength.
  2638. If you want a longer sample then add more space after the mix has been done.)
  2639. The ':' after the 4 digits shows that the samplelength is set to its maximum!
  2640.  
  2641. * Major7
  2642. will set a major7 chord, depending on the basenote.
  2643.  
  2644. * Minor7
  2645. will set a minor7 chord, depending on the basenote.
  2646.  
  2647. * Major6
  2648. will set a major6 chord, depending on the basenote.
  2649.  
  2650. * Minor6
  2651. will set a minor6 chord, depending on the basenote.
  2652.  
  2653. * 4 notegadgets
  2654. The upper one is the basenote.If you press a gadget, PT will wait for you to
  2655. press a note.Holding the right mousebutton will reset the note
  2656.  
  2657. * 4 Up/Down gadgets
  2658. will add/sub 1 halfnote from the current note.Holding right button will
  2659. add/sub 1 octave.You can reset the note by adding past B-3.
  2660.  
  2661. * The 4 rightmost gadgets
  2662. works just like the edit op gadgets. 1,2,3 takes you to the corresponding
  2663. edit option, and E exits
  2664.  
  2665. * The statusline
  2666. pressing the upper line will toggle between New or Old sample:
  2667. If N, then PT will search for an free sample to put the result.
  2668. If O, then PT will put the result on the current sample, overwriting the
  2669. original sample
  2670.  
  2671. Note1!
  2672. ------
  2673. This version of PT resets repeat and replen. PT also puts a '!' last in the
  2674. samplename to show you that this is a chord sample.The '!' is for you to see
  2675. where the destination-sample has gone,it has nothing to do with the program.
  2676. You can take the '!' away and rename the sample to ...-major , ...-minor etc
  2677. for instance.
  2678.  
  2679. Note2!
  2680. ------
  2681. The chosen option on the statusline in edit op. 3 ,H(alve) or C(lip)
  2682. will affect the chord resampling and mixing!
  2683.  
  2684. Ok, that was the chord gadgets!
  2685.  
  2686. ***********************************************************************
  2687.  
  2688. Position-Editor
  2689. ---------------
  2690. Press 'POS' on the mainscreen to get to the Position-Editor.
  2691. All the gadgets should be well known, pressing the big gadget at the
  2692. top will stop the song. Keyboard input works too,Left Alt,Left Amiga,space
  2693. and the cursor up/down arrows.You can use the Position,pattern and length
  2694. gadgets on the main screen, or click in the list to alter the current
  2695. pattern or to enter a name to each pattern if you'd like to.
  2696. The Patternnames will be loaded/saved if you have the corresponding toggles
  2697. ON (load names,save names). The files will have the mod. exchanged to mod!
  2698. just to distuingish them from the real modules. The patternnames will be
  2699. cleared if you choose clear song or clear all.Another way is to click on
  2700. each name you'd like to clear and then press the right mouse button.
  2701. Patternplay works a little different from in the mainscreen.The pattern
  2702. shown on the edit-row(the current position) will be played instead of the
  2703. pattern currently shown in the notedatawindow.
  2704.  
  2705. HEY! The patternnames has no effect on the module, they are just to remind
  2706. the musician of the contents of the patterns, eg. you can name the first
  2707. three patterns to INTRO just to remind yourself that those three patterns
  2708. are the intro to your tune!
  2709.  
  2710. ***********************************************************************
  2711.  
  2712. Other NEW things:
  2713. -----------------
  2714.  
  2715. On request, I have made ''multitasking'' like in PT1.3. I am not sure if
  2716. this works correctly, but i have tested it a lot without trouble.
  2717. LeftAmiga+N, LeftAmiga+M should work fine.
  2718.  
  2719.  
  2720. ProTracker has it's own screen. When the PT screen is in front of all other
  2721. screens, PT will wake up.
  2722.  
  2723.  
  2724. The browse function is modified to act like PT1.3. It shows the current
  2725. devices and disknames.
  2726. If you hold the right mousebutton while pressing the browse gadget a disklist
  2727. will pop up showing all the device- and disknames from the browsegadget in the
  2728. filenamewindow. Pressing a name will autoload that directory. If there are
  2729. more than eight entries, just use the arrow up/down keys or the up/down
  2730. gadgets.
  2731.  
  2732.  
  2733. If you press LeftShift+any key 0-9 a-z while in DiskOp,
  2734. PLST or PresetEd, PT will move you to the position in the list with a name
  2735. beginning with the corresponding character.If not found you will end up in
  2736. the end of the list.
  2737.  
  2738.  
  2739. If you use MIDI I've added two new keys. A-2 and B-2 on the Synthkeyboard
  2740. are used as SampleNumber Up/Down! I have also Transposed the MIDInotes input
  2741. one octave down (because one of my friends had a small keyboard and couldn't
  2742. access the upper octave,C#3 - B-3).
  2743.  
  2744.  
  2745. On request from 'The green Lark/Aliens' I have added a SaveExecutable option.
  2746. Hold the right mousebutton while pressing save module. This will remove
  2747. 'mod.' from the filename and add '.exe', and save the file in the current
  2748. modules-dir. This won't crunch the module though.
  2749.  
  2750.  
  2751. 9 new toggles: (all of them isn't working at the moment)
  2752. --------------
  2753. * Salvage
  2754. * 100 Patterns
  2755. * Save Icons
  2756. * Load PatternNames
  2757. * Save PatternNames
  2758. * Load PLST when starting PT
  2759. * Screen Adjust
  2760. * Save IFF/Raw packed sample
  2761. * System Requests
  2762.  
  2763. You can now have modules with 100 patterns. If you save a module with more
  2764. than 64 patterns then M.K. in the moduleheader will be changed to M!K!
  2765.  
  2766. **************************************************************************
  2767.  
  2768. Some info to you who test this beta version:
  2769. --------------------------------------------
  2770.  
  2771. I am not sure if the make chord function handles Out of memory correct. Test
  2772. it and report about the memory handling, if you get an Out of memory message!
  2773.  
  2774.  
  2775. Check out the crunching! report bugs. Please note that powerpacker.library
  2776. doesn't crunch ok everytime. Test to load the packed file and check before
  2777. deleting the original file! If the packed file is improperly packed then try
  2778. to crunch it with powerpacker (4.0 or greater) instead and if that file
  2779. doesn't work either then there may be a bug in PT.
  2780.  
  2781.  
  2782. I have noticed that after answerring an errorrequest in the WBscreen, PT wont
  2783. automatically pop up. I have fixed this on some requests but not on all
  2784. requests.
  2785.  
  2786. --------------------------------------------------------------------------
  2787.  
  2788. Ok thats all for now.Thanks to all of you who have written to me, giving some
  2789. bugreports and some new ideas.
  2790.  
  2791. Especially thanks to:
  2792.  
  2793. Devistator/EOC1999    Spirou/Visual Design    Sun/Dreamdealers
  2794.  
  2795. The Green Lark/Aliens    Matrix/LSD (Thanks for the source!)
  2796.  
  2797. Deltabar Dilonardo    Toni Maenpaa        Markus Jentsch
  2798.  
  2799. Alex Kunz        Tritoon/AlphaFlight
  2800.  
  2801. --------------------------------------------------------------------------
  2802. Note to Sun/Dreamdealers: (about that sample problem)
  2803. --------------------------------------------------------------------------
  2804.  
  2805. I have located the bug, and I have fixed it.
  2806.  
  2807. In PT2.1A, if you loaded samples that were between $5c00 and $5dff long, then
  2808. PT acted strange! the length of the sample was set between $0000 and $01ff,
  2809. but if you had loops on, it played correctly.
  2810.  
  2811. There was a little bug in the routine that searched the samplename for the
  2812. extension '.pp' , and if found erased it. The bug has now been corrected.
  2813.  
  2814. --------------------------------------------------------------------------
  2815.  
  2816. Ok, I hope you test this beta version thoroughly and report bugs. Please
  2817. describe the bugs properly and state what computer,KS and memory you have.
  2818. I'd prefer a step by step description.
  2819.  
  2820. --------------------------------------------------------------------------
  2821.  
  2822.  
  2823.                         Peter 'Crayon' Hanning
  2824.                            Mushroom studios
  2825.                              Noxious -92
  2826.  
  2827.  
  2828.  
  2829. My addy:
  2830.  
  2831. Peter Hanning
  2832. Vinterstigen 12
  2833. 14440 Ronninge
  2834. Sweden
  2835.  
  2836. ***************************************************************************
  2837.  
  2838.  
  2839.